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

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

会員管理・認証（Android）

基本的な使い方

概要

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

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

アプリでの実装

会員の新規登録

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

//　Userインスタンスの生成
NCMBUser user = new NCMBUser();

// ユーザー名・パスワードを設定
user.setUserName("Yamada Tarou"); /* ユーザー名 */
user.setPassword("password"); /* パスワード */

// ユーザーの新規登録処理
user.signUpInBackground(new DoneCallback() {
    @Override
    public void done(NCMBException e) {
        if (e != null) {
            // 会員登録時にエラーが発生した場合の処理
        }
    }
});
ログイン

新規登録が完了すると、ログインができるようになります。
ログインは loginInBackground メソッドを用います。引数にはユーザー情報をユーザ名とパスワードで設定します。

NCMB.initialize(this.getApplicationContext(),"APP_KEY","CLIENT_KEY");

// ログイン
try {
    NCMBUser.loginInBackground("Yamada Tarou", "password", new LoginCallback() {
        @Override
        public void done(NCMBUser user, NCMBException e) {
            if (e != null) {
                // エラー処理
                Log.d("Debug",e.getMessage());
            } else {
                // ログイン後処理
                Log.d("Debug", "ログイン中のユーザー: " + user.getUserName());
            }
        }
    });
} catch (NCMBException exception) {
    Log.d("Debug",exception.getMessage());
}

また、ログイン することでログインしたユーザーは カレントユーザー として設定されます。カレントユーザーの権限で mBaaS 上のオブジェクトにアクセスできるようになります。

参考：データストア(Android)：アクセス権限設定

セッショントークン

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

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

カレントユーザー

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

// カレントユーザー情報の取得
NCMBUser user = NCMBUser.getCurrentUser();
if(user != null){
    Log.d("Debug", "ログイン中のユーザー: " + user.getUserName());
} else {
    Log.d("Debug", "未ログインまたは取得に失敗");
}

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

ログアウト

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

// ログアウト
NCMBUser.logoutInBackground(new DoneCallback() {
    @Override
    public void done(NCMBException e) {
        if (e != null) {
            //エラー時の処理
        }
    }
});

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

会員の削除

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

NCMBUser user = NCMBUser.getCurrentUser();
user.deleteObjectInBackground(new DoneCallback() {
    @Override
    public void done(NCMBException e) {
        if (e != null) {
            Log.d("Debug", "削除に失敗しました");
        } else {
            Log.d("Debug", "退会しました");
        }
    }
});

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

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

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

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

NCMBUser currentUser = NCMBUser.getCurrentUser();
if(currentUser != null){
    if (currentUser.isMailAddressConfirmed()) {
        // メールアドレス確認済み
    } else {
        // メールアドレス未確認
    }
}
パスワードのリセット

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

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

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

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

NCMBUser.requestPasswordResetInBackground("mail@example.com", new DoneCallback() {
    @Override
    public void done(NCMBException error) {
        if(error != null ){
            // エラー処理
        } else {
            // 送信後処理
        }
    }
});
会員情報の検索

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

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

try {
    //　Userインスタンスの生成
    NCMBUser user = new NCMBUser();
    user.setUserName("Taro");
    user.setPassword("password");

    NCMBAcl acl = new NCMBAcl();
    acl.setPublicReadAccess(true);

    user.setAcl(acl);

    user.signUpInBackground(new DoneCallback() {
        @Override
        public void done(NCMBException e) {
            if (e != null) {
                // 会員登録時にエラーが発生した場合の処理
            }
        }
    });
} catch (NCMBException e) {
    // エラー処理
}

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

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

NCMBQuery<NCMBUser> query = new NCMBQuery<>("user");
query.whereEqualTo("userName", "Taro");

query.findInBackground(new FindCallback<NCMBUser>() {
    @Override
    public void done(List<NCMBUser> results, NCMBException e) {
        if (e != null) {
            //検索失敗時の処理
        }
    }
});

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

ポインタ

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

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

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

try {
    //カレントユーザーのnameフィールドにTaroを追加する
    NCMBUser currentUser = NCMBUser.getCurrentUser();
    currentUser.setUserName("Tarou");
    currentUser.saveInBackground(new DoneCallback() {
        @Override
        public void done(NCMBException e) {
            if (e == null) {
                //成功時の処理
            }
        }
    });

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

    //カレントユーザー情報にポインタで紐づける
    currentUser.put("任意のフィールド名", user);
    currentUser.saveInBackground(new DoneCallback() {
        @Override
        public void done(NCMBException e) {
            if (e == null) {
                //成功時の処理
            }
        }
    });
} catch (NCMBException ncmbException) {
    // エラー処理
}

管理画面での操作

会員の追加と編集を行う

新しい会員ボタンをクリックして、新しい会員の新規作成を選択します。
会員の新規作成

作成した会員の情報はブラウザーからも編集可能です。
会員情報の編集
会員の名前を編集し、エンターキーをクリックすることで、以下のように保存されました。
会員情報の保存

会員を削除する

レコードの左側にあるチェックボックスを選択し、削除ボタンをクリックすると会員を削除してもいいかを確認する画面が開きます。

削除ボタンをクリックすると、会員が削除されます。

フィールドを追加する

1．新しいフィールドボタンをクリックすると作成画面が表示されます。

2．フィールド名を入力すると新しくフィールドが作成されます。

フィールドを削除する

1．画面右上のクラスの編集ボタンを選択します。

2．チェックボックスを選択し削除ボタンをクリックします。

3．確認が画面が表示され削除ボタンでフィールドが削除されます。

会員認証の方法を設定する

アプリ設定の会員認証設定を開くと、ID/パスワードによる認証や
メールアドレス/パスワードによる認証の設定を行うことができます。
二つの認証方法は、下記画像のように両方有効にすることも可能です。

お探しの内容が見つからなかった場合はユーザーコミュニティ もご活用ください。（回答保証はいたしかねます）
なお、 Expertプラン以上のお客様はテクニカルサポートにてご質問を承らせて頂きます。

推奨画面サイズ1024×768px以上

ページの先頭へ