Azure Mobile Apps 用 .NET バックエンドサーバー SDK の操作

[アーティクル]
10/01/2016

このトピックでは、Azure App Service Mobile Apps の主要なシナリオで .NET バックエンドサーバー SDK を使用する方法について説明します。 Azure Mobile Apps SDK を使用すると、ASP.NET アプリケーションからモバイルクライアントを操作することができます。

ヒント

Azure Mobile Apps 向け .NET サーバー SDK は、オープンソースとして GitHub で公開されています。リポジトリには、サーバー全体の SDK ユニットテストスイートといくつかのサンプルプロジェクトを含むすべてのソースコードが含まれています。

リファレンスドキュメント

サーバー SDK のリファレンスドキュメントについては、「Azure Mobile Apps .NET リファレンス」を参照してください。

方法: .NET モバイルアプリバックエンドを作成する

新しいプロジェクトを開始する場合は、 Azure ポータルまたは Visual Studio を使用して、App Service アプリケーションを作成できます。 App Service アプリケーションをローカルで実行することも、プロジェクトをクラウドベースの App Service モバイルアプリに発行することもできます。

既存のプロジェクトにモバイル機能を追加する場合は、「 SDK をダウンロードして初期化する」セクションを参照してください。

Azure ポータルで .NET バックエンドを作成する

App Service モバイルバックエンドを作成するには、クイックスタートチュートリアルまたは次の手順に従います。

Azure Portal にサインインします。
[+新しい>Web + モバイル>モバイルアプリ] を選択し、Mobile Apps バックエンドの名前を指定します。
[リソースグループ] で、既存のリソースグループを選択するか、新しく作成します (アプリと同じ名前を使用)。
[App Service プラン] では、既定のプラン (Standard レベル) が選択されています。別のプランを選択することも、新しいプランを作成することもできます。

App Service プランの設定により、アプリに関連付けられる場所、機能、コスト、コンピューティングリソースが決まります。 App Services プランの詳細と、さまざまな価格レベルおよび目的の場所で新しいプランを作成する方法については、「Azure App Service プランの概要」を参照してください。
［作成］ を選択しますこの手順により、Mobile Apps バックエンドが作成されます。
新しい Mobile Apps バックエンドの [設定] ウィンドウで、クライアントアプリプラットフォーム>の [データベースの接続] をクイックスタート>を選択します。
[データ接続の追加] ウィンドウで、[SQL Database]>[新しいデータベースの作成] の順に選択します。データベース名を入力し、価格レベルを選択して、[サーバー] を選択します。この新しいデータベースは再利用できます。同じ場所に既にデータベースを所有している場合は、代わりに [既存のデータベースの使用]を選択することもできます。別の場所にあるデータベースを使用することはお勧めしません。このようなデータベースを使用すると、帯域幅コストと待機時間が増加します。
[新しいサーバー] ウィンドウで、[サーバー名] ボックスに一意のサーバー名を入力し、ログインとパスワードを指定して、[Azure サービスにサーバーへのアクセスを許可する]、[OK] の順に選択します。この手順により、新しいデータベースが作成されます。
[データ接続の追加] ウィンドウに戻り、[接続文字列] を選択し、データベースのログインとパスワードの値を入力して、[OK] を選択します。

データベースが正常にデプロイされるまで数分待ってから、次の手順に進んでください。

[テーブル API の作成] の [はじめに] ブレードに戻り、[バックエンド言語] として [C#] を選択します。 [ダウンロード]をクリックし、圧縮されたプロジェクトファイルをローカルコンピューターに抽出して、Visual Studio でソリューションを開きます。

Visual Studio 2017 を使用して .NET バックエンドを作成する

Visual Studio インストーラーを使用して Azure ワークロードをインストールし、Visual Studio から Azure Mobile Apps プロジェクトに発行します。 SDK のインストールが完了したら、次の手順を使用して ASP.NET アプリケーションを作成します。

[新しいプロジェクト] ダイアログを開きます ([ファイル]>[新規作成]>[プロジェクト...] の順にクリック)。
[Visual C#] を展開し、[Web] を選択します。
[ASP.NET Web アプリケーション (.NET Framework)] を選択します。
プロジェクト名を入力します。次に、 [OK] をクリックします
テンプレートの一覧から [Azure Mobile App] を選択します。
[ OK] を クリックしてソリューションを作成します。
ソリューションエクスプローラーでプロジェクトを右クリックし、[発行...] を選択し、発行のターゲットとして [App Service] を選択します。
プロンプトに従って認証し、発行する新規または既存の Azure App Service を選択します。

Visual Studio 2015 を使用して .NET バックエンドを作成する

Visual Studio で Azure Mobile Apps プロジェクトを作成するには、Azure SDK for .NET (バージョン 2.9.0 以降) をインストールします。 SDK のインストールが完了したら、次の手順を使用して ASP.NET アプリケーションを作成します。

[新しいプロジェクト] ダイアログを開きます ([ファイル]>[新規作成]>[プロジェクト...] の順にクリック)。
[テンプレート Visual>C#] を展開し、[Web] を選択します。
[ASP.NET Web アプリケーション]を選択します。
プロジェクト名を入力します。次に、 [OK] をクリックします
ASP.NET 4.5.2 テンプレートの [Azure Mobile App]を選択します。このプロジェクトの発行先となるクラウドにモバイルバックエンドを作成するために、 [Host in the cloud (クラウドにホストする)] チェックボックスをオンにします。
[OK] をクリックします。

方法: SDK をダウンロードして初期化する

SDK は NuGet.org で使用できます。このパッケージには、SDK の使用を開始するために必要な基本機能が含まれています。 SDK を初期化するには、 HttpConfiguration オブジェクトに対して操作を実行する必要があります。

SDK のインストール

SDK をインストールするには、Visual Studio でサーバープロジェクトを右クリックして [NuGet パッケージの管理] を選択し、Microsoft.Azure.Mobile.Server パッケージを検索してから、[インストール] をクリックします。

サーバープロジェクトの初期化

.NET バックエンドサーバープロジェクトは、他の ASP.NET プロジェクトと同じように、OWIN スタートアップクラスを組み込むことによって初期化します。 NuGet パッケージ Microsoft.Owin.Host.SystemWebが参照されていることを確認します。 Visual Studio でこのクラスを追加するには、サーバープロジェクトを右クリックし、新しい項目の追加>、Web>General>OWIN Startup クラスの順に選択します。次の属性を持つクラスが生成されます。

[assembly: OwinStartup(typeof(YourServiceName.YourStartupClassName))]

OWIN スタートアップクラスの Configuration() メソッドで、 HttpConfiguration オブジェクトを使用して Azure Mobile Apps 環境を構成します。次の例では、機能を追加せずにサーバープロジェクトを初期化します。

// in OWIN startup class
public void Configuration(IAppBuilder app)
{
    HttpConfiguration config = new HttpConfiguration();

    new MobileAppConfiguration()
        // no added features
        .ApplyTo(config);

    app.UseWebApi(config);
}

個別の機能を有効化するには、ApplyTo を呼び出す前に、MobileAppConfiguration オブジェクトに対して拡張機能メソッドを呼び出す必要があります。たとえば、次のコードでは、初期化中に [MobileAppController] 属性が設定されているすべての API コントローラーに既定のルートを追加します。

new MobileAppConfiguration()
    .MapApiControllers()
    .ApplyTo(config);

Azure ポータルからのサーバーのクイックスタートは UseDefaultConfiguration()を呼び出します。これは次のセットアップと同等です。

    new MobileAppConfiguration()
        .AddMobileAppHomeController()             // from the Home package
        .MapApiControllers()
        .AddTables(                               // from the Tables package
            new MobileAppTableConfiguration()
                .MapTableControllers()
                .AddEntityFramework()             // from the Entity package
            )
        .AddPushNotifications()                   // from the Notifications package
        .MapLegacyCrossDomainController()         // from the CrossDomain package
        .ApplyTo(config);

使用する拡張メソッドは次のとおりです。

AddMobileAppHomeController() は、既定の Azure Mobile Apps ホームページを提供します。
MapApiControllers() は、[MobileAppController] 属性で修飾された WebAPI コントローラーのカスタム API 機能を提供します。
AddTables() は、テーブルコントローラーへの /tables エンドポイントのマッピングを提供します。
AddTablesWithEntityFramework() は、Entity Framework ベースのコントローラーを使用して /tables エンドポイントをマッピングするための簡単な方法です。
AddPushNotifications() を使用すると、Notification Hubs 用のデバイスを簡単に登録できます。
MapLegacyCrossDomainController() は、ローカル開発のための標準 CORS ヘッダーを提供します。

SDK 拡張機能

次の NuGet ベースの拡張機能パッケージでは、アプリケーションで使用可能な各種モバイル機能が提供されます。拡張機能の有効化は、初期化中に MobileAppConfiguration オブジェクトを使用して行います。

Microsoft.Azure.Mobile.Server.Quickstart Mobile Apps の基本的なセットアップをサポートします。構成に追加するには、初期化中に UseDefaultConfiguration 拡張機能メソッドを呼び出します。この拡張機能には、Notifications、Authentication、Entity、Tables、Cross-domain、および Home パッケージが含まれています。このパッケージは、Azure Portal で利用可能な Mobile Apps クイックスタートで使用されます。
Microsoft.Azure.Mobile.Server.Home Web サイトのルートに、 このモバイルアプリが実行される既定のページ を実装します。構成に追加するには、 AddMobileAppHomeController 拡張メソッドを呼び出します。
Microsoft.Azure.Mobile.Server.Tables データ処理のためのクラスが含まれており、データパイプラインを設定します。構成に追加するには、 AddTables 拡張メソッドを呼び出します。
Microsoft.Azure.Mobile.Server.Entity Entity Framework で SQL Database のデータにアクセスできるようにします。構成に追加するには、 AddTablesWithEntityFramework 拡張メソッドを呼び出します。
Microsoft.Azure.Mobile.Server.Authentication 認証を有効にし、トークンの検証に使用する OWIN ミドルウェアを設定します。構成に追加するには、AddAppServiceAuthentication 拡張メソッドと IAppBuilder.UseAppServiceAuthentication 拡張メソッドを呼び出します。
Microsoft.Azure.Mobile.Server.Notifications プッシュ通知を有効にし、プッシュ登録エンドポイントを定義します。構成に追加するには、 AddPushNotifications 拡張メソッドを呼び出します。
Microsoft.Azure.Mobile.Server.CrossDomain モバイルアプリから従来の Web ブラウザーにデータを提供するコントローラーを作成します。構成に追加するには、 MapLegacyCrossDomainController 拡張メソッドを呼び出します。
Microsoft.Azure.Mobile.Server.Login カスタム認証シナリオで使用される静的メソッドである AppServiceLoginHandler.CreateToken() メソッドを提供します。

方法: サーバープロジェクトを発行する

このセクションでは、Visual Studio から .NET バックエンドプロジェクトを発行する方法を示します。 Git やその他の利用可能な方法を利用して、バックエンドプロジェクトをデプロイすることもできます。

Visual Studio でプロジェクトをリビルドして、NuGet パッケージを復元します。
ソリューションエクスプローラーで目的のプロジェクトを右クリックし、 [発行]をクリックします。初めて発行するときには、発行プロファイルを定義する必要があります。既に定義したプロファイルがある場合は、それを選択し、[発行] をクリックします。
発行先の選択を求められたら、Microsoft Azure App Service>Next をクリックし、必要に応じて Azure 資格情報でサインインします。 Visual Studio によって Azure から発行設定が直接ダウンロードされ、安全に保存されます。
サブスクリプションを選択し、[表示] で [リソースの種類] を選択して、[モバイルアプリ] を展開します。次に、モバイルアプリバックエンドをクリックし、[OK] をクリックします。
発行プロファイル情報を確認し、 [発行]をクリックします。

モバイルアプリバックエンドが正常に発行されると、そのことを示すランディングページが表示されます。

方法: テーブルコントローラーを定義する

SQL テーブルをモバイルクライアントに公開するためのテーブルコントローラーを定義します。テーブルコントローラーを構成するには、3 つの手順が必要です。

データ転送オブジェクト (DTO) クラスを作成する。
Mobile DbContext クラスにテーブル参照を構成する。
テーブルコントローラーを作成する。

データ転送オブジェクト (DTO) は、 EntityDataから継承するプレーンな C# オブジェクトです。たとえば、次のように入力します。

public class TodoItem : EntityData
{
    public string Text { get; set; }
    public bool Complete {get; set;}
}

DTO を使用して、SQL データベース内にテーブルを定義します。データベースエントリを作成するには、使用している DbContext に DbSet<> プロパティを追加します。 Azure Mobile Apps の既定のプロジェクトテンプレートでは、DbContext が Models\MobileServiceContext.csと記述されています。

public class MobileServiceContext : DbContext
{
    private const string connectionStringName = "Name=MS_TableConnectionString";

    public MobileServiceContext() : base(connectionStringName)
    {

    }

    public DbSet<TodoItem> TodoItems { get; set; }

    protected override void OnModelCreating(DbModelBuilder modelBuilder)
    {
        modelBuilder.Conventions.Add(
            new AttributeToColumnAnnotationConvention<TableColumnAttribute, string>(
                "ServiceColumnTable", (property, attributes) => attributes.Single().ColumnType.ToString()));
    }
}

Azure SDK をインストール済みの場合は、テンプレートテーブルコントローラーを次のように作成できます。

Controllers フォルダーを右クリックし、[コントローラーの追加>]... を選択します。
[Azure Mobile Apps のテーブルコントローラー] オプションを選択し、[追加] をクリックします。
[コントローラーの追加] ダイアログボックスで、次の手順を実行します。
- [モデルクラス] ボックスの一覧で、新しい DTO を選択します。
- [DbContext] ボックスの一覧で、モバイルサービス DbContext クラスを選択します。
- コントローラー名は自動的に作成されます。
[追加] をクリックします。

クイックスタートサーバープロジェクトには、シンプルな TodoItemControllerの例が含まれています。

方法: テーブルのページングサイズを調整する

既定では、Azure Mobile Apps は、要求ごとに 50 個のレコードを返します。ページングにより、クライアントが長期間 UI スレッドまたはサーバーを占有することがなくなるため、優れたユーザーエクスペリエンスが保証されます。テーブルのページングサイズを変更するには、サーバー側の "許可されているクエリサイズ" とクライアント側のページサイズを大きくします。サーバー側の "許可されているクエリサイズ" は、EnableQuery 属性を使用して調整します。

[EnableQuery(PageSize = 500)]

PageSize が、クライアントから要求されるサイズ以上になるようにしてください。クライアントのページサイズを変更する方法の詳細については、特定のクライアントのハウツードキュメントを参照してください。

方法: カスタム API コントローラーを定義する

カスタム API コントローラーは、エンドポイントを公開して、モバイルアプリのバックエンドに最も基本的な機能を提供します。 [MobileAppController] 属性を使用して、モバイル固有の API コントローラーを登録できます。この属性により MobileAppController 、ルートが登録され、Mobile Apps JSON シリアライザーが設定され、クライアントバージョンのチェックが有効になります。

Visual Studio で、[コントローラー] フォルダーを右クリックし、[コントローラーの追加>] をクリックし、[Web API 2 コントローラー - 空] を選択し、[追加] をクリックします。
コントローラー名 (CustomController など) を指定し、[追加] をクリックします。
新しいコントローラーのクラスファイルに、次の using ステートメントを追加します。
```
 using Microsoft.Azure.Mobile.Server.Config;
```
次の例に従って、API コントローラーのクラス定義に [MobileAppController] 属性を適用します。
```
 [MobileAppController]
 public class CustomController : ApiController
 {
       //...
 }
```
次の例に示すように、App_Start/Startup.MobileApp.cs ファイルに MapApiControllers 拡張メソッドの呼び出しを追加します。
```
 new MobileAppConfiguration()
     .MapApiControllers()
     .ApplyTo(config);
```

MapApiControllers() の代わりに UseDefaultConfiguration() 拡張メソッドを使用することもできます。クライアントは MobileAppControllerAttribute が適用されていないコントローラーにもアクセスできますが、こうしたコントローラーはモバイルアプリクライアント SDK を使用するクライアントでは適切に使用されない場合があります。

方法: 認証を操作する

Azure Mobile Apps は、App Service 認証/承認を使用してモバイルバックエンドをセキュリティで保護します。このセクションでは、.NET バックエンドサーバープロジェクトで以下の認証関連のタスクを実行する方法を説明します。

方法: サーバープロジェクトに認証を追加する
方法: アプリケーションにカスタム認証を使用する
方法: 認証済みユーザー情報を取得する
方法: 承認されたユーザーのデータアクセスを制限する

方法: サーバープロジェクトに認証を追加する

MobileAppConfiguration オブジェクトを拡張し、OWIN ミドルウェアを構成すると、サーバープロジェクトに認証を追加することができます。 Microsoft.Azure.Mobile.Server.Quickstart パッケージをインストールし、 UseDefaultConfiguration 拡張メソッドを呼び出している場合は、手順 3 に進むことができます。

Visual Studio で、 Microsoft.Azure.Mobile.Server.Authentication パッケージをインストールします。
Startup.cs プロジェクトファイルで、 Configuration メソッドの先頭に次のコード行を追加します。
```
 app.UseAppServiceAuthentication(config);
```
この OWIN ミドルウェアコンポーネントは、関連付けられている App Service ゲートウェイによって発行されたトークンを検証します。
認証が必要なすべてのコントローラーまたはメソッドに [Authorize] 属性を追加します。

Mobile Apps バックエンドに対してクライアントを認証する方法については、「アプリケーションに認証を追加する」をご覧ください。

方法: アプリケーションにカスタム認証を使用する

重要

カスタム認証を有効にするには、まず、Azure Portal で App Service のプロバイダーを選択せずに App Service 認証を有効にする必要があります。ホストされている場合は、これにより WEBSITE_AUTH_SIGNING_KEY 環境変数が有効になります。

App Service 認証/承認プロバイダーの中に使用したいものがない場合は、独自のログインシステムを実装できます。認証トークンの生成に役立つ Microsoft.Azure.Mobile.Server.Login パッケージをインストールします。ユーザー資格情報を検証するための独自のコードを指定します。たとえば、データベース内のソルトを使用してハッシュ化されたパスワードと照合することができます。次の例では、(他の場所に定義されている) isValidAssertion() メソッドがこれらの照合を実行します。

カスタム認証を公開するには、ApiController を作成し、register アクションと login アクションを公開します。クライアントは、カスタム UI を使用してユーザーから情報を収集する必要があります。その後、この情報は、標準の HTTP POST 呼び出しで API に送信されます。サーバーでアサーションを検証したら、 AppServiceLoginHandler.CreateToken() メソッドを使用してトークンを発行します。 ApiController で [MobileAppController] 属性を使用することはできません。

login アクションの例:

    public IHttpActionResult Post([FromBody] JObject assertion)
    {
        if (isValidAssertion(assertion)) // user-defined function, checks against a database
        {
            JwtSecurityToken token = AppServiceLoginHandler.CreateToken(new Claim[] { new Claim(JwtRegisteredClaimNames.Sub, assertion["username"]) },
                mySigningKey,
                myAppURL,
                myAppURL,
                TimeSpan.FromHours(24) );
            return Ok(new LoginResult()
            {
                AuthenticationToken = token.RawData,
                User = new LoginResultUser() { UserId = userName.ToString() }
            });
        }
        else // user assertion was not valid
        {
            return this.Request.CreateUnauthorizedResponse();
        }
    }

前の例の LoginResult と LoginResultUser は、必要なプロパティを公開する、シリアル化可能なオブジェクトです。クライアントでは、ログインの応答が次の形式の JSON オブジェクトとして返されるものと想定されています。

    {
        "authenticationToken": "<token>",
        "user": {
            "userId": "<userId>"
        }
    }

AppServiceLoginHandler.CreateToken() メソッドには、audience パラメーターと issuer パラメーターが含まれています。どちらのパラメーターも、HTTPS スキームを使用してアプリケーションルートの URL に設定します。同様に、secretKey をアプリケーションの署名キーの値に設定する必要があります。キーを生成してユーザーを偽装するために使用される可能性があるため、クライアントで署名キーを配布しないでください。 WEBSITE_AUTH_SIGNING_KEY環境変数を参照することで、App Serviceでホストされている間に署名キーを取得できます。ローカルデバッグの実行で必要な場合は、「認証に関するローカルデバッグ」セクションの手順に従ってキーを取得し、アプリケーション設定として保存します。

また、発行されたトークンには、他の要求および有効期限を含めることもできます。少なくとも、発行されたトークンには、サブジェクト (sub) 要求が含まれている必要があります。

認証ルートをオーバーロードすることにより、標準クライアント loginAsync() メソッドをサポートできます。クライアントが client.loginAsync('custom'); を呼び出してログインする場合、ルートは /.auth/login/custom である必要があります。カスタム認証コントローラーのルートは、 MapHttpRoute()を使用して設定できます。

config.Routes.MapHttpRoute("custom", ".auth/login/custom", new { controller = "CustomAuth" });

ヒント

loginAsync() アプローチを使用すると、後続のサービスのすべての呼び出しに認証トークンが添付されます。

方法: 認証されたユーザー情報を取得する

ユーザーが App Service によって認証されると、.NET バックエンドコードで、割り当てられたユーザー ID とその他の情報にアクセスできます。このユーザー情報を使用して、バックエンドで承認の決定を行うことができます。次のコードは、要求に関連付けられているユーザー ID を取得します。

// Get the SID of the current user.
var claimsPrincipal = this.User as ClaimsPrincipal;
string sid = claimsPrincipal.FindFirst(ClaimTypes.NameIdentifier).Value;

SID はプロバイダー固有のユーザー ID から派生し、特定のユーザーとログインプロバイダーに対して静的です。無効な認証トークンの SID は null です。

App Service では、ログインプロバイダーからの特定の要求を行うこともできます。各 ID プロバイダーは、ID プロバイダー SDK を使用してさらに多くの情報を提供できます。たとえば、友人の情報については Facebook Graph API を使用できます。 Azure Portal のプロバイダーブレードで、要求された要求を指定できます。要求によっては、ID プロバイダーの追加の構成が必要です。

次のコードは、GetAppServiceIdentityAsync 拡張メソッドを呼び出して、ログイン資格情報を取得します。この情報には、Facebook Graph API に対する要求を行うために必要なアクセストークンが含まれています。

// Get the credentials for the logged-in user.
var credentials =
    await this.User
    .GetAppServiceIdentityAsync<FacebookCredentials>(this.Request);

if (credentials.Provider == "Facebook")
{
    // Create a query string with the Facebook access token.
    var fbRequestUrl = "https://graph.facebook.com/me/feed?access_token="
        + credentials.AccessToken;

    // Create an HttpClient request.
    var client = new System.Net.Http.HttpClient();

    // Request the current user info from Facebook.
    var resp = await client.GetAsync(fbRequestUrl);
    resp.EnsureSuccessStatusCode();

    // Do something here with the Facebook user information.
    var fbInfo = await resp.Content.ReadAsStringAsync();
}

GetAppServiceIdentityAsync 拡張メソッドを提供するには、System.Security.Principal の using ステートメントを追加します。

方法: 承認されたユーザーに対するデータアクセスを制限する

前のセクションでは、認証されたユーザーのユーザー ID を取得する方法について説明しました。この値に基づいて、データとその他のリソースへのアクセスを制限できます。たとえば、UserId 列をテーブルに追加して、ユーザー ID によってクエリの結果をフィルター処理すると、承認されたユーザーだけにデータが返されるように簡単に制限できます。次のコードは、SID が TodoItem テーブルの UserId 列の値と一致する場合にのみデータ行を返します。

// Get the SID of the current user.
var claimsPrincipal = this.User as ClaimsPrincipal;
string sid = claimsPrincipal.FindFirst(ClaimTypes.NameIdentifier).Value;

// Only return data rows that belong to the current user.
return Query().Where(t => t.UserId == sid);

Query() メソッドは、フィルター処理を行うために LINQ で操作できる IQueryable を返します。

方法: サーバープロジェクトにプッシュ通知を追加する

MobileAppConfiguration オブジェクトを拡張し、Notification Hubs クライアントを作成して、サーバープロジェクトにプッシュ通知を追加します。

Visual Studio でサーバープロジェクトを右クリックし、[NuGet パッケージの管理] をクリックして Microsoft.Azure.Mobile.Server.Notifications を見つけ、[インストール] をクリックします。
上記の手順を繰り返して、Notification Hubs クライアントライブラリが含まれる Microsoft.Azure.NotificationHubs パッケージをインストールします。
App_Start/Startup.MobileApp.cs で、初期化中に AddPushNotifications() 拡張メソッドの呼び出しを追加します。
```
 new MobileAppConfiguration()
     // other features...
     .AddPushNotifications()
     .ApplyTo(config);
```

Notification Hubs クライアントを作成する次のコードを追加します。

 // Get the settings for the server project.
 HttpConfiguration config = this.Configuration;
 MobileAppSettingsDictionary settings =
     config.GetMobileAppSettingsProvider().GetMobileAppSettings();

 // Get the Notification Hubs credentials for the Mobile App.
 string notificationHubName = settings.NotificationHubName;
 string notificationHubConnection = settings
     .Connections[MobileAppSettingsKeys.NotificationHubConnectionString].ConnectionString;

 // Create a new Notification Hub client.
 NotificationHubClient hub = NotificationHubClient
     .CreateClientFromConnectionString(notificationHubConnection, notificationHubName);

これで、Notification Hubs クライアントを使用して、登録済みデバイスにプッシュ通知を送信できるようになりました。詳細については、「アプリにプッシュ通知を追加する」を参照してください。 Notification Hubs の詳細については、 Notification Hubs の概要に関するページを参照してください。

方法: タグを使用してターゲットプッシュを有効にする

Notification Hubs では、タグを使用して、ターゲットを絞った通知を特定の登録に送信できます。いくつかのタグは自動的に作成されます。

インストール ID は、特定のデバイスを識別します。
認証済みの SID に基づくユーザー ID は、特定のユーザーを識別します。

インストール ID には、MobileServiceClient の installationId プロパティからアクセスできます。次の例では、Notification Hubs でインストール ID を使用して特定のインストールにタグを追加する方法を示します。

hub.PatchInstallation("my-installation-id", new[]
{
    new PartialUpdateOperation
    {
        Operation = UpdateOperationType.Add,
        Path = "/tags",
        Value = "{my-tag}"
    }
});

インストールを作成するときは、プッシュ通知の登録時にクライアントから提供されたタグはすべてバックエンドで無視されます。クライアントがインストールにタグを追加できるようにするには、前述のパターンを使用してタグを追加するカスタム API を作成する必要があります。

例については、App Service Mobile Apps の完成したクイックスタートサンプルのクライアントによって追加されるプッシュ通知タグに関するセクションを参照してください。

方法: 認証されたユーザーにプッシュ通知を送信する

認証済みのユーザーがプッシュ通知に登録すると、ユーザー ID タグが登録に自動的に追加されます。このタグを使用すると、そのユーザーが登録したすべてのデバイスにプッシュ通知を送信できます。次のコードでは、要求を行ったユーザーの SID を取得し、そのユーザーのすべてのデバイス登録にテンプレートプッシュ通知を送信します。

// Get the current user SID and create a tag for the current user.
var claimsPrincipal = this.User as ClaimsPrincipal;
string sid = claimsPrincipal.FindFirst(ClaimTypes.NameIdentifier).Value;
string userTag = "_UserId:" + sid;

// Build a dictionary for the template with the item message text.
var notification = new Dictionary<string, string> { { "message", item.Text } };

// Send a template notification to the user ID.
await hub.SendTemplateNotificationAsync(notification, userTag);

認証されたクライアントからプッシュ通知を登録する場合は、登録を試みる前に、認証が完了していることを確認します。詳細については、「.NET バックエンド向けの App Service Mobile Apps の完成したクイックスタートサンプル」の「ユーザーへのプッシュ」をご覧ください。

方法: .NET サーバー SDK のデバッグとトラブルシューティングを実行する

Azure App Service には、ASP.NET アプリケーションのデバッグとトラブルシューティングの方法が複数用意されています。

ログの記録

標準の ASP.NET トレース書き込みを使用して、App Service の診断ログを作成できます。ログに書き込めるようにするには、モバイルアプリバックエンドで診断を有効にする必要があります。

診断を有効にしてログに書き込むには、次の手順を実行します。

「アプリケーションのログ記録を有効にする (Windows)」の手順に従います。
次の using ステートメントをコードファイルに追加します。
```
 using System.Web.Http.Tracing;
```
.NET バックエンドから診断ログに書き込むために、次のようにトレースライターを作成します。
```
 ITraceWriter traceWriter = this.Configuration.Services.GetTraceWriter();
 traceWriter.Info("Hello, World");
```
サーバープロジェクトを再発行し、モバイルアプリバックエンドにアクセスして、ログ記録付きでコードパスを実行します。
「ログファイルにアクセスする」で説明されているように、ログをダウンロードして評価します。

認証に関するローカルデバッグ

クラウドに発行する前に変更をテストするために、ローカルでアプリケーションを実行できます。ほとんどの Azure Mobile Apps バックエンドでは、Visual Studio で F5 キーを押します。ただし、認証を使用している場合は追加の考慮事項がいくつかあります。

App Service Authentication/Authorization を使用してクラウドベースのモバイルアプリを構成する必要があります。また、クライアントに代替ログインホストとしてクラウドエンドポイントを指定する必要があります。必要な手順の詳細については、クライアントプラットフォームのドキュメントを参照してください。

モバイルバックエンドに Microsoft.Azure.Mobile.Server.Authentication がインストールされていることを確認します。次に、MobileAppConfiguration が HttpConfiguration に適用された後で、アプリケーションの OWIN Startup クラスに次のコードを追加します。

    app.UseAppServiceAuthentication(new AppServiceAuthenticationOptions()
    {
        SigningKey = ConfigurationManager.AppSettings["authSigningKey"],
        ValidAudiences = new[] { ConfigurationManager.AppSettings["authAudience"] },
        ValidIssuers = new[] { ConfigurationManager.AppSettings["authIssuer"] },
        TokenHandler = config.GetAppServiceTokenHandler()
    });

前の例では、Web.config ファイル内のアプリケーション設定 authAudience と authIssuer を、HTTPS スキームを使用して、それぞれアプリケーションルートの URL に構成する必要があります。同様に、authSigningKey をアプリケーションの署名キーの値に設定する必要があります。署名キーを取得するには、次の手順を実行します。

Azure ポータル
[ツール]、[Kudu]、[移動] の順にクリックします。
Kudu 管理サイトで、 [環境]をクリックします。
WEBSITE_AUTH_SIGNING_KEYの値を見つけます。

ローカルアプリケーション構成で、authSigningKey パラメーターに署名キーを使用します。モバイルバックエンドには、現在、ローカルでの実行時にトークンを検証する機能が備わっています。このトークンは、クライアントによってクラウドベースのエンドポイントから取得されます。

次の方法で共有

Azure Mobile Apps 用 .NET バックエンド サーバー SDK の操作

リファレンス ドキュメント

方法: .NET モバイル アプリ バックエンドを作成する