iOS アプリに認証を追加する

[アーティクル]
06/25/2019

このチュートリアルでは、サポートされている ID プロバイダーを使用して、 iOS クイックスタートプロジェクトに認証を追加します。最初に、このチュートリアルの基になっている iOS クイックスタートチュートリアルを完了しておく必要があります。

アプリケーションを認証に登録し、App Service を構成する

最初に、ID プロバイダーのサイトでアプリを登録する必要があります。その後、プロバイダーによって生成された資格情報を Mobile Apps バックエンドに設定します。

次のプロバイダー固有の指示に従い、任意の ID プロバイダーを構成します。
アプリ内でサポートするプロバイダーごとに、前の手順を繰り返します。

許可されている外部リダイレクト URL にアプリを追加する

認証をセキュリティで保護するには、アプリ用の新しい URL スキームの定義が必要になります。これによって、認証プロセスが完了すると認証システムからアプリにリダイレクトできます。このチュートリアル全体を通して、URL スキーム appname を使用します。ただし、選択したあらゆる URL スキームを使用できます。 URL スキームは、モバイルアプリに対して一意である必要があります。サーバー側でリダイレクトを有効にするには、以下の手順に従います。

Azure Portal で、App Service を選択します。
[認証/承認] メニューオプションをクリックします。
[認証プロバイダー] セクションの下の [Azure Active Directory] をクリックします。
[Management mode (管理モード)] を [Advanced (詳細)] に設定します。
[Allowed External Redirect URLs (許可されている外部リダイレクト URL)] に appname://easyauth.callback を入力します。この文字列の appname は、モバイルアプリケーションの URL スキームです。プロトコルの通常の URL 仕様 (文字と数字のみを使用し、文字で始まる) に従う必要があります。数か所で URL スキームに合わせてモバイルアプリケーションコードを調整する必要があるため、選択した文字列をメモしておく必要があります。
[OK] をクリックします。
[保存] をクリックします。

アクセス許可を、認証されたユーザーだけに制限する

既定では、Mobile Apps バックエンドの API は匿名で呼び出すことができます。次に、認証されたクライアントのみにアクセスを制限する必要があります。

Node.js バックエンド (Azure Portal 経由):

Mobile Apps の設定で、[ 簡単なテーブル ] をクリックし、テーブルを選択します。 [アクセス許可の変更] をクリックし、すべてのアクセス許可に対して [Authenticated access only (認証済みアクセスのみ)] を選択し、[保存] をクリックします。
.NET バックエンド (C#):

サーバープロジェクトで、 Controllers>TodoItemController.cs に移動します。次のように、 [Authorize] 属性を TodoItemController クラスに追加します。アクセスを特定のメソッドのみに制限するには、この属性を、クラスではなく、そのメソッドのみに適用するだけです。サーバープロジェクトを発行します。
```
  [Authorize]
  public class TodoItemController : TableController<TodoItem>
```
Node.js バックエンド (Node.js コード経由) :

テーブルへのアクセスに対して認証を要求するには、Node.js サーバースクリプトに次の行を追加します。
```
  table.access = 'authenticated';
```
詳細については、「方法: テーブルへのアクセスに認証を要求する」を参照してください。自社サイトからクイックスタートコードプロジェクトをダウンロードする方法については、「方法: Git を使用して Node.js バックエンドクイックスタートコードプロジェクトをダウンロードする」を参照してください。

Xcode で、 [Run] をクリックしてアプリケーションを開始します。認証されないユーザーとしてアプリがバックエンドにアクセスしようとしても、TodoItem テーブルで認証が要求されるために例外が発生します。

アプリケーションに認証を追加する

Objective-C:

Mac の Xcode で QSTodoListViewController.m を開き、次のメソッドを追加します。
```
- (void)loginAndGetData
{
    QSAppDelegate *appDelegate = (QSAppDelegate *)[UIApplication sharedApplication].delegate;
    appDelegate.qsTodoService = self.todoService;

    [self.todoService.client loginWithProvider:@"google" urlScheme:@"appname" controller:self animated:YES completion:^(MSUser * _Nullable user, NSError * _Nullable error) {
        if (error) {
            NSLog(@"Login failed with error: %@, %@", error, [error userInfo]);
        }
        else {
            self.todoService.client.currentUser = user;
            NSLog(@"User logged in: %@", user.userId);

            [self refresh];
        }
    }];
}
```
Google を ID プロバイダーとして使用しない場合は、google を microsoftaccount、twitter、facebook、windowsazureactivedirectory のいずれかに変更します。 Facebook を使用する場合は、アプリで Facebook ドメインを許可リストに登録する必要があります。

urlScheme をアプリケーションの一意の名前に置き換えます。 urlScheme は、Azure Portal [Allowed External Redirect URLs (許可されている外部リダイレクト URL)] フィールドに指定した URL スキームプロトコルと同じにする必要があります。 urlScheme は、認証要求が完了した後にアプリケーションに戻るために、認証コールバックで使用されます。
QSTodoListViewController.m 内の viewDidLoad の [self refresh] を次のコードに置き換えます。
```
[self loginAndGetData];
```

QSAppDelegate.h ファイルを開き、次のコードを追加します。

#import "QSTodoService.h"

@property (strong, nonatomic) QSTodoService *qsTodoService;

QSAppDelegate.m ファイルを開き、次のコードを追加します。

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
    if ([[url.scheme lowercaseString] isEqualToString:@"appname"]) {
        // Resume login flow
        return [self.qsTodoService.client resumeWithURL:url];
    }
    else {
        return NO;
    }
}

#pragma mark - Core Data stack という行の前にこのコードを直接追加します。 appname を、手順 1. で使用した urlScheme 値で置き換えます。

AppName-Info.plist ファイル (AppName はアプリの名前で置き換える) を開き、次のコードを追加します。
```
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>com.microsoft.azure.zumo</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>appname</string>
        </array>
    </dict>
</array>
```
このコードは、<dict> 要素内に配置する必要があります。 appname 文字列 (CFBundleURLSchemes の配列内) を、手順 1 で選択したアプリ名で置き換えます。 plist エディターでこれらに変更を加えることもできます。XCode で AppName-Info.plist ファイルをクリックして plist エディターを開きます。

CFBundleURLName の com.microsoft.azure.zumo 文字列を Apple のバンドル識別子で置き換えます。
[実行] をクリックしてアプリを起動したら、ログインします。ログインが成功すると、Todo リストを表示して更新できます。

Swift:

Mac の Xcode で ToDoTableViewController.swift を開き、次のメソッドを追加します。
```
func loginAndGetData() {

    guard let client = self.table?.client, client.currentUser == nil else {
        return
    }

    let appDelegate = UIApplication.shared.delegate as! AppDelegate
    appDelegate.todoTableViewController = self

    let loginBlock: MSClientLoginBlock = {(user, error) -> Void in
        if (error != nil) {
            print("Error: \(error?.localizedDescription)")
        }
        else {
            client.currentUser = user
            print("User logged in: \(user?.userId)")
        }
    }

    client.login(withProvider:"google", urlScheme: "appname", controller: self, animated: true, completion: loginBlock)

}
```
Google を ID プロバイダーとして使用しない場合は、google を microsoftaccount、twitter、facebook、windowsazureactivedirectory のいずれかに変更します。 Facebook を使用する場合、アプリで Facebook ドメインをホワイトリストに追加する必要があります。

urlScheme をアプリケーションの一意の名前に置き換えます。 urlScheme は、Azure Portal [Allowed External Redirect URLs (許可されている外部リダイレクト URL)] フィールドに指定した URL スキームプロトコルと同じにする必要があります。 urlScheme は、認証要求が完了した後にアプリケーションに戻るために、認証コールバックで使用されます。
ToDoTableViewController.swiftの viewDidLoad() の最後にある self.refreshControl?.beginRefreshing() と self.onRefresh(self.refreshControl) の行を削除します。その場所に loginAndGetData() の呼び出しを追加します。
```
loginAndGetData()
```

AppDelegate.swift ファイルを開き、次のコード行を AppDelegate クラスに追加します。

var todoTableViewController: ToDoTableViewController?

func application(_ application: UIApplication, openURL url: NSURL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
    if url.scheme?.lowercased() == "appname" {
        return (todoTableViewController!.table?.client.resume(with: url as URL))!
    }
    else {
        return false
    }
}

appname を、手順 1. で使用した urlScheme 値で置き換えます。

AppName-Info.plist ファイル (AppName はアプリの名前で置き換える) を開き、次のコードを追加します。
```
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>com.microsoft.azure.zumo</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>appname</string>
        </array>
    </dict>
</array>
```
このコードは、<dict> 要素内に配置する必要があります。 appname 文字列 (CFBundleURLSchemes の配列内) を、手順 1 で選択したアプリ名で置き換えます。 plist エディターでこれらに変更を加えることもできます。XCode で AppName-Info.plist ファイルをクリックして plist エディターを開きます。

CFBundleURLName の com.microsoft.azure.zumo 文字列を Apple のバンドル識別子で置き換えます。
[実行] をクリックしてアプリを起動したら、ログインします。ログインが成功すると、Todo リストを表示して更新できます。

App Service の認証では、Apple の Inter-App Communication が使用されます。このトピックの詳細については、Apple のドキュメントを参照してください。

iOS アプリに認証を追加する

アプリケーションを認証に登録し、App Service を構成する

許可されている外部リダイレクト URL にアプリを追加する

アクセス許可を、認証されたユーザーだけに制限する

アプリケーションに認証を追加する

その他のリソース