サーバー構築不要！スマートフォンアプリ向けの新クラウド

トップ >ドキュメント >会員管理・認証（Obj-C）:基本的な使い方

このサイトを正しく表示するためには、ブラウザーのJavaScriptの設定を「有効」にしてください。

会員管理・認証（Obj-C）

iOS
(Swift)
iOS
(Obj-C)
Android
(Kotlin)
Android
(Java)
JavaScript
Monaca
Unity

基本的な使い方

1 概要
2 アプリでの実装
3 管理画面での操作

概要

ニフクラ mobile backend での会員の認証方法は以下の4種類です。

ユーザー名・パスワードでの認証
メールアドレス・パスワードでの認証
- 会員管理・認証 (iOS) : メールアドレス認証
SNSアカウントでの認証
匿名認証
- 会員管理・認証・認証 (iOS) : 匿名認証

このページでは、ユーザー名・パスワードでの認証方法について説明していきますので、
それ以外の認証方法を実装したい場合は、各ドキュメントをご覧ください。

アプリでの実装

ユーザーの新規登録

User のインスタンスを作成後、userName と password を設定して signUpInBackgroundWithBlock メソッドで登録処理を行います。

//　Userインスタンスの生成
NCMBUser *user = [NCMBUser user];

// ユーザー名・パスワードを設定
user.userName = @"Yamada Tarou"; /* ユーザー名 */
user.password = @"password"; /* パスワード */

// ユーザーの新規登録処理
[user signUpInBackgroundWithBlock:^(NSError *error) {
    if (!error) {
        NSLog(@"ユーザーの新規登録に成功");
    } else {
        NSLog(@"ユーザーの新規登録に失敗: %@", error);
    }
}];

ログインするとセッショントークンが発行されます。通信時に利用されるセッショントークンは、カレントユーザーに設定されているものです。ログアウトすることでセッショントークンを無効にし、ログイン状態を終了します。

セッショントークンの有効期限は通常24時間です
有効期限切れのセッショントークンでは通信できません
セッショントークンの有効期限は管理画面にて変更可能です

カレントユーザー

ログイン中のユーザーはカレントユーザーとして設定されます。 currentUser メソッドを用いることで、現在カレントユーザーに設定されているユーザ情報を取得することができます。
また、画面遷移などによって保持していたセッショントークン情報が失われた場合にも、
currentUser を実行することで、ローカルに保存されているカレントユーザー情報から
セッショントークンを設定をし直すことができます。

// カレントユーザー情報の取得
NCMBUser *currentUser = [NCMBUser currentUser];
if (currentUser) {
    NSLog(@"ログイン中のユーザー: %@", currentUser.userName);
} else {
    NSLog(@"未ログインまたは取得に失敗");
}

参考：自動ログイン処理を実現するには？
アプリ再起動時に自動ログインを実施したい場合は、カレントユーザーを取得した上でセッショントークンの有効期限が切れていないかどうかを確認する処理の実装が必要です。

ログアウト

ログアウトは logOut メソッドを利用します。ログアウトすることで、カレントユーザー情報がリセットされます。

// ログアウト
[NCMBUser logOut];

参考：インスタンスを用いてログインしている場合の注意点
ログアウトによりシステム上のセッショントークンは無効となりますが、インスタンスのプロパティは残ります。プロパティが残っているとセッショントークンの再取得ができないため、同一ユーザで再度ログインする場合には事前にインスタンスのログアウトを実行する必要があります。

会員の削除

会員の削除は deleteInBackgroundWithBlock プロパティを利用します。会員を削除することで、会員管理に保存されているデータが物理削除されます。

NCMBUser *currentUser = [NCMBUser currentUser];
[currentUser deleteInBackgroundWithBlock:^(NSError *error) {
    if (!error){
                NSLog(@"退会しました");
    } else {
                NSLog(@"削除に失敗しました: %@", error);
    }
}];

※2022年6月30日以降、App Store Review ガイドライン 5.1.1において、アカウント作成に対応しているすべてのAppを対象に、App内でアカウントを削除できるようにしなければならないという要件が追加されました。詳細はこちら

メールアドレス確認の有無

メールアドレスが確認済みかどうかを調べるには isMailAddressConfirm メソッドを使用します。

参考：「メールアドレス確認」とは？
メールアドレス認証を利用する場合、ユーザーの新規登録時に登録メールアドレス宛にメールを配信し、配信されたメールから認証を行う手順があります。この手順が実施されている状態が「メールアドレス確認済み」となります。他の認証方法でもユーザー情報にメールアドレスを設定することが可能ですが、「メールアドレス確認」が実施されていないアカウントはメールアドレス認証を利用できません。

NCMBUser *currentUser = [NCMBUser currentUser];
if(currentUser){
    if(NCMBUser.currentUser.isMailAddressConfirm){
        // メールアドレス確認済み
    } else {
        // メールアドレス未確認
    }
}

パスワードのリセット

パスワードのリセットはメールアドレスの登録があるユーザーのみ行えます。以下のようにリセット要求を発行すると、登録メールアドレスに

仮パスワード
会員パスワード変更ページのURL

が送信されます。会員パスワード変更ページでパスワードの変更が可能です。
なお、URLの有効期限は24時間です。メールを受信してから24時間ではありませんので、ご注意ください。

参考：パスワード変更 API は用意しておりません。パスワードの変更を行いたい場合はパスワードのリセットの処理が必要です。

[NCMBUser requestPasswordResetForEmailInBackground:@"mail@example.com" block:^(NSError *error) {
    if(error){
        // エラー処理
    } else {
        // 送信後処理
    }
}];

会員情報の検索

データストアの基本的な検索の利用同様、会員管理・認証のデータを検索することが可能です。

※デフォルトの権限では、会員データは本人のみデータの読み込みや更新が可能となっているため、必要に応じて以下のように新規会員登録もしくはログイン時に権限を変更する必要があります。

//　Userインスタンスの生成
NCMBUser *user = [NCMBUser user];
// ユーザー名・パスワードを設定
user.userName = @"Taro";
user.password = @"password";
NCMBACL *acl = [NCMBACL ACL];
[acl setPublicReadAccess:YES];
[user setACL:acl];

// ユーザーの新規登録処理
[user signUpInBackgroundWithBlock:^(NSError *error) {
    if (!error) {
        NSLog(@"ユーザーの新規登録に成功");
    } else {
        NSLog(@"ユーザーの新規登録に失敗: %@", error);
    }
}];

オブジェクトを検索する場合は、検索条件を設定し、検索実行メソッドfindObjectsInBackgroundWithBlockをメソッドチェーンで続けて実行します。

※limitを指定していない場合、検索結果として取得される最大データ件数は100件です。
検索結果のデータ件数が多い場合は、limitとskipを活用してください。
詳細は取得件数の指定と取得開始位置の指定をご覧ください。

NCMBQuery *query = [NCMBQuery queryWithClassName:@"user"];

//userNameがTaroと一致するデータを検索する条件を設定
[query whereKey:@"userName" equalTo:@"Taro"];

//データストアの検索を実施
[query findObjectsInBackgroundWithBlock:^(NSArray *objects, NSError *error) {
    if (error) {
        //検索失敗時の処理
    } else {
        //検索成功時の処理
    }
}];

より効率的に検索するにはこちらをご参考ください。

ポインタ

データストアのポインタ同様、あるオブジェクトのプロパティにほかのオブジェクトをセットすることで、それらを関連づけることができます。

オブジェクトのプロパティにほかのオブジェクトを直接入力した場合、保存時にそのオブジェクトへのポインタが設定されます。

※ログイン済みの会員情報に追加する必要があるため、カレントユーザー情報に紐づけます

//ポインタで紐づけたい会員情報のobjectIdを会員管理に追加する
NCMBUser *user =  [NCMBUser user];
[user setObjectId:@"対象オブジェクトID"];

NCMBUser *currentUser = [NCMBUser currentUser];
//カレントユーザー情報にポインタで紐づける
[currentUser setObject:user forKey:@"任意のフィールド名"];
[currentUser saveInBackgroundWithBlock:^(NSError *error) {
    if (!error) {
        //成功時の処理
    }
}];