クレームに関するチュートリアル: ASP.NET SQL のメンバーシッププロバイダーとロールプロバイダーを使用したクレームベースの SharePoint 2010 Web アプリケーション用のフォームベース認証の作成

[アーティクル]
07/02/2015

概要: ASP.NET SQL のメンバーシッププロバイダーとロールプロバイダーを使用して、クレームベースの Web アプリケーション用にフォームベース認証を作成する方法について説明します。

最終更新日: 2013年1月18日

この記事の内容
ASP.NET SQL のメンバーシッププロバイダーとロールプロバイダーによるクレームベース Web アプリケーションの認証の概要
手順 1: SharePoint Web アプリケーションの作成
手順 2: Web アプリケーションに ASP.NET のメンバーシップおよびロールプロバイダーを使用するためのデータベースの準備
手順 3: SharePoint Web アプリケーション用のメンバーシップとロールプロバイダーの構成
手順 4: メンバーシップおよびロールプロバイダーデータベースへのユーザーとロールの追加
手順 5: フォームベース認証のテスト
手順 6: (オプション) 構成およびハンドルされない例外のエラーのトラブルシューティング
手順 7: クレームの表示
手順 8: 新しいユーザーとロールの追加
まとめ
その他の技術情報

提供元: Andy Li、Microsoft Corporation

ASP.NET SQL のメンバーシッププロバイダーとロールプロバイダーによるクレームベース Web アプリケーションの認証の概要
手順 1: SharePoint Web アプリケーションの作成
手順 2: Web アプリケーションに ASP.NET のメンバーシップおよびロールプロバイダーを使用するためのデータベースの準備
手順 3: SharePoint Web アプリケーション用のメンバーシップとロールプロバイダーの構成
手順 4: メンバーシップおよびロールプロバイダーデータベースへのユーザーとロールの追加
手順 5: フォームベース認証のテスト
手順 6: (オプション) 構成およびハンドルされない例外のエラーのトラブルシューティング
手順 7: クレームの表示
手順 8: 新しいユーザーとロールの追加
まとめ
その他の技術情報

ダウンロードコード: ClaimsExample-CreateFormsBasedAuthentication (英語)

ASP.NET SQL のメンバーシッププロバイダーとロールプロバイダーによるクレームベース Web アプリケーションの認証の概要

このチュートリアルでは、Microsoft ASP.NET のメンバーシップとロールプロバイダーを認証プロバイダーとして使用して、クレームベースの Web アプリケーションを作成します。

フォームベース認証は、個別のユーザーを識別して認証するためのインターフェイスを定義するメンバーシッププロバイダーと、個別のユーザーを論理的なグループつまりロールにグループ化するためのインターフェイスを定義するロールマネージャーを実装することで、Microsoft SharePoint 2010 におけるカスタム ID 管理を提供します。

この記事は、読者がフォームベース認証をよく理解しているという前提で書かれています。フォームベース認証の詳細については、「SharePoint 製品とテクノロジのフォーム認証 (パート 1): 概要」を参照してください。

手順 1: SharePoint Web アプリケーションの作成

注意

この記事からコマンドラインコマンドを単純にコピーして実行しようとすると、エラーが発生する場合があります。これは、一部の文字が書式設定の間に特殊文字に変換されるためです。たとえば、ハイフン記号 (-) をこの記事からコピーすると、コマンドプロンプトウィンドウで正しく動作しない場合があります。

SharePoint Web アプリケーションを作成するには

SharePoint 2010 サーバーの全体管理ページを表示します。
[アプリケーション構成の管理] セクションで、[Web アプリケーションの管理] をクリックします。
リボンで、[新規作成] をクリックします。
[新しい Web アプリケーションの作成] ダイアログボックスの、[認証] で、[クレームベースの認証] をクリックします。
[IIS Web サイト] セクションの [新しい IIS Web サイトを作成する] で、[名前] フィールドを「SharePoint – SQL FBA」に変更します。
[ポート] 番号を 200 に変更します。
[クレーム認証の種類] セクションで、以下の操作を実行します。
- [フォームベース認証 (FBA) の有効化] を選択します。
- 他の認証モードをオフにします。
メンバーシッププロバイダーとロールマネージャーのフィールドに、次の名前を入力します。
- ASP.NET メンバーシッププロバイダー名: aspnetmembership
- ASP.NET ロールマネージャー名: aspnetrolemanager
  
  注意
  
  メンバーシッププロバイダーとロールプロバイダーはまだ設定してありません。これらは後の手順で作成します。
[URL] を「http://intranet.contoso.com:200」に変更します。
[データベース名と認証] セクションで、データベース名を「WSS_Content_200」に変更します。
その他の設定は既定のままにします。
[OK] をクリックして、Web アプリケーションを作成します。

手順 2: Web アプリケーションに ASP.NET のメンバーシップおよびロールプロバイダーを使用するためのデータベースの準備

ここでは、ASP.NET のメンバーシッププロバイダーとロールプロバイダー用に、Microsoft SQL Server データベースを手動で準備します。この構成はツールで行うこともできます。ここでは手作業で行うことにより、構成に含まれるプロバイダーのすべての要素の理解が深まるようにします。

注意

Microsoft SQL Server メンバーシッププロバイダーは、ユーザー情報を SQL Server データベースに格納します。コマンドラインから Aspnet_regsql.exe を実行することで、SQL Server ユーザーストアを手動で作成できます。または、Aspnet_regsql.exe をウィザードモードで実行することも (「ASP.NET SQL Server 登録ツール (Aspnet_regsql.exe)」を参照)、または ASP.NET 構成ツールを使用することもできます。ASP.NET 構成ツールは、Microsoft Visual Studio の [Web サイト] メニューにあります。

Web アプリケーションに ASP.NET メンバーシッププロバイダーおよびロールプロバイダーを使用するようにデータベースを準備するには

Microsoft SQL Server Management Studio を起動して、ローカルサーバーインスタンスに接続します。
図 1 に示すように、aspnetdb_claim という名前の新しいデータベースを追加します。

図 1. aspnetdb_claim という名前の新しいデータベースの作成
aspnet_regsql.exe を使用して、メンバーシップデータベースを作成します。コマンドプロンプトウィンドウを開きます。次のコマンドラインコマンドを実行して、Microsoft .NET Framework 2.0 ディレクトリに変更します。

cd C:\Windows\Microsoft.NET\Framework64\v2.0.50727
図 2 に示すように、次のコマンドを実行します。

aspnet_regsql -S DEMO2010A -E -A mr –d aspnetdb_claim

-S    サーバーを指定します。この例ではサーバーはローカルです。

-E    Windows 認証を使用して SQL Server に接続することを指定します。

-A mr   メンバーシップおよびロール機能を追加することを指定します。

-d    データベースの名前を指定します。

図 2. aspnet_regsql.exe を使用したメンバーシップデータベースの作成
aspnetdb_claim ノードを展開し、すべてのテーブルが作成されていることを確認します。

図 3. 展開された aspnetdb_claim ノード
Web アプリケーションの AppPool アカウントに、データベースへのアクセスを許可します。Web アプリケーションは contoso\adminstrator を使用してログオンするので、このデータベースへのフルアクセスが自動的に設定されているはずです。

手順 3: SharePoint Web アプリケーション用のメンバーシップとロールプロバイダーの構成

3 つの web.config ファイルを変更する必要があります。

サーバーの全体管理: サイトコレクション用の選択を許可するため。
セキュリティトークンサービス: サインインを許可し、トークンを発行するため。
FBA Web アプリケーション: ローカル Web アプリケーションでの選択を許可するため。

SharePoint Web アプリケーション用にメンバーシッププロバイダーおよびロールプロバイダーを構成するには

SQL フォームベース認証 Web アプリケーションの web.config ファイルで、終了の </configSections> タグの後に次の接続文字列を追加します。

注意

次の例を貼り付ける場合、タブ文字または空白文字が追加されることがあります。web.config を変更するときに、タブ文字または空白文字が追加されていないことを確認してください。

接続文字列を追加した後の web.config ファイルは、次の例のようになります。
```
<connectionStrings>
  <add name="MyLocalSQLServer"
       connectionString="Initial Catalog=aspnetdb_claim;data source=DEMO2010A;Integrated Security=SSPI;" />
</connectionStrings>
```
前の手順を、サーバーの全体管理 Web サイトおよび SecurityTokenServiceApplication Web サイトに対して繰り返します。

図 4 に示すように、SecurityTokenServiceApplication Web サイトは SharePoint Web サービス Web サイトの下にあります。

図 4. SecurityTokenServiceApplication Web サイトの場所
フォームベース認証 Web アプリケーションの Web サイト (http://intranet.contoso.com:200) に戻り、web.config ファイルを再び開きます。

<membership> タグの下にある <Providers> タグの中に次のコードを追加します (図 5 を参照)。

  <add name="aspnetmembership" 
             connectionStringName="MyLocalSQLServer" 
             applicationName="MyAppName" 
             type="System.Web.Security.SqlMembershipProvider, 
             System.Web, Version=2.0.0.0, Culture=neutral, 
             PublicKeyToken=b03f5f7f11d50a3a" />

図 5. FBA Web アプリケーションの web.config ファイルでのプロバイダーの値

プロバイダーの値

<RoleManager> セクションの下にある <Providers> タグに、次のロールマネージャー要素を追加します (図 6 を参照)。
```
        <add name="aspnetrolemanager" 
             type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
             connectionStringName="MyLocalSQLServer"
             applicationName="MyAppName" />
```
図 6. FBA Web アプリケーションの web.config ファイルでのロールマネージャーの値

注意

applicationName 属性では、Web アプリケーションのアプリケーション名を指定します。これは、ASP.NET のメンバーシッププロバイダーおよびロールプロバイダーがユーザーを一意に識別するために使用する名前です。
手順 1. から手順 5. までを、サーバーの全体管理 Web サイトと SecurityTokenServiceApplication Web サイトの両方に対して繰り返します。

注意

SharePoint セキュリティトークンサービス (STS) Web サイトの web.config ファイルには <system.web> セクションが含まれないので、セクションを手動で追加する必要があります。図 4 に示すように、SecurityTokenServiceApplication Web サイトは SharePoint Web サービス Web サイトの下にあります。完成した web.config ファイルの例を見るには、この記事に付属するダウンロード (ClaimsExample-CreateFormsBasedAuthentication (英語)) に含まれる構成ファイルを開いてください。

手順 4: メンバーシップおよびロールプロバイダーデータベースへのユーザーとロールの追加

次に、メンバーシップとロールのプロバイダーデータベースに、ユーザーとロールを追加します。

メンバーシップおよびロールのプロバイダーデータベースにユーザーとロールを追加するには

Microsoft SQL Server Management Studio を起動し、図 7 に示すように、aspnetdb_claim データベースに対して次のクエリを実行します。
```
declare @now datetime
set @now= GETDATE()
exec aspnet_Membership_CreateUser 'MyAppName','admin1','pass@word1',
    '','admin1@contoso.com','','',1,@now,@now,0,0,null
```
図 7. aspnetdb_claim データベースのクエリ
図 8 に示すように、次のクエリを実行してユーザー admin1 を Admin ロールに追加します。
```
EXEC aspnet_Roles_CreateRole 'MyAppName', 'Admin'
EXEC aspnet_UsersInRoles_AddUsersToRoles 'MyAppName', 'admin1', 'Admin', 8 
```
図 8. Admin ロールへのユーザー admin1 の追加

手順 5: フォームベース認証のテスト

次に、フォームベースの認証をテストします。

フォームベースの認証をテストするには

サーバーの全体管理 Web サイトで、[アプリケーション構成の管理] の [サイトコレクションの作成] をクリックします。
[Web アプリケーション] ボックスの一覧で、FBA Web アプリケーション http://intranet.contoso.com:200 を選択します (図 9 を参照)。

図 9. Web アプリケーションの構成
[タイトル] フィールドの値を「FBA Site」に変更します。
[ユーザー名] フィールドで、[参照] をクリックし、追加したユーザーを検索します。
図 10 に示すように、検索ボックスに「admin1」と入力し、検索ボタンをクリックします。

図 10. ユーザー選択ウィンドウ
結果領域で admin1 ユーザーをダブルクリックします。サイトコレクション作成ページに自動的に戻ります。
[OK] をクリックして、サイトコレクションを作成します。
http://intranet.contoso.com:200 に移動します。図 11 のようなログオンページが表示されます。

図 11. ログオンページ
次の資格情報を入力して、[Sign In] をクリックします。
- ユーザー名: admin1
- パスワード: pass@word1
ログオンした後、図 12 に示すように、右上隅のユーザー名に admin1 と表示されることを確認します。

図 12. ユーザー admin1 が認証された後の SharePoint サイト

手順 6: (オプション) 構成およびハンドルされない例外のエラーのトラブルシューティング

図 13 は、web.config ファイルに誤った構成を入力した場合に表示されるエラーです。すべての SharePoint プロセスのすべての web.config ファイルを編集する必要があることに注意してください。この記事に付属するダウンロードには、参照用に 3 つの web.config ファイルが収められています。図 14 はハンドルされない例外のエラーです。

図 13. メンバーシッププロバイダー構成エラー

メンバーシッププロバイダー構成エラー

図 14. ハンドルされない例外エラー

未処理の例外エラー

ハンドルされない例外エラーが発生する場合は、図 15 のように、値 includeExceptionDetailInFaults を <serviceBehaviors> セクションに追加する必要があります。

図 15. <serviceBehaviors> セクションへの includeExceptionDetailInFaults の追加

includeExceptionDetailInFaults 値の追加

手順 7: クレームの表示

次に、クレームを表示します。

クレームを表示するには

Web パーツを作成し、RenderContent 関数を次のコードに置き換えます。Microsoft.IdentityModel.dll の参照および名前空間 Microsoft.IdentityModel.Claims の追加が必要な場合があります。

        protected override void RenderContents(HtmlTextWriter writer)
        {
            try
            {
                IClaimsIdentity currentIdentity = System.Threading.Thread.CurrentPrincipal.Identity as IClaimsIdentity;
                writer.Write("---Subject:" + currentIdentity.Name + "<BR/>");

                foreach (Claim claim in currentIdentity.Claims)
                {
                    writer.Write("   ClaimType: " + claim.ClaimType + "<BR/>");
                    writer.Write("   ClaimValue: " + claim.Value + "<BR/");
                    writer.Write("   ClaimValueTypes: " + claim.ValueType + "<BR/>");
                    writer.Write("   Issuer: " + claim.Issuer + "<BR/");
                    writer.Write("   OriginalIssuer: " + claim.OriginalIssuer + "<BR/>");
                    writer.Write("   Properties: " + claim.Properties.Count.ToString() + "<BR/>");
                }
            }
            catch (Exception ex)
            {
                writer.Write("exception occurred: " + ex.Message);
            }

        }

ソリューションを展開し、FBA サイト Web アプリケーションのホームページに Web パーツを追加します (図 16 を参照)。

図 16. クレームの種類とクレームの値の情報
次の 2 つのクレームに注意してください。
```
ClaimType: https://schemas.microsoft.com/sharepoint/2009/08/claims/userid
ClaimValue: 0#.f|aspnetmembership|admin1
ClaimType: https://schemas.microsoft.com/ws/2008/06/identity/claims/role
ClaimValue: Admin
```
ロールクレームは、ASP.NET ロールプロバイダーから取得されます。Admin はユーザーに割り当てたロールの名前であることを思い出してください。SQL クエリを実行してユーザーのロールを追加したときのロールは admin1 です。

手順 8: 新しいユーザーとロールの追加

次に、新しいユーザーとロールを追加します。

ユーザーとロールをさらに追加するには

プロバイダーにさらにユーザーとロールを追加するには、次の SQL クエリを実行します。

declare @now datetime
set @now= GETDATE()

exec aspnet_Membership_CreateUser 'MyAppName','bob','pass@word1',
    '','bob@contoso.com','','',1,@now,@now,0,0,null
exec aspnet_Membership_CreateUser 'MyAppName','mary','pass@word1',
    '','mary@contoso.com','','',1,@now,@now,0,0,null
exec aspnet_Membership_CreateUser 'MyAppName','jack','pass@word1',
'','jack@contoso.com','','',1,@now,@now,0,0,null

EXEC aspnet_Roles_CreateRole 'MyAppName', 'Employee'
EXEC aspnet_Roles_CreateRole 'MyAppName', 'TeamManager'
EXEC aspnet_Roles_CreateRole 'MyAppName', 'CEO'

EXEC aspnet_UsersInRoles_AddUsersToRoles 'MyAppName', 'bob', 'Employee', 8 
EXEC aspnet_UsersInRoles_AddUsersToRoles 'MyAppName', 'mary', 'TeamManager', 8 
EXEC aspnet_UsersInRoles_AddUsersToRoles 'MyAppName', 'jack', 'CEO', 8 
EXEC aspnet_UsersInRoles_AddUsersToRoles 'MyAppName', 'jack', 'Admin', 8

リボンの [サイトの操作の] で、[サイトの権限] を選択して、[アクセス許可の付与] をクリックします。[参照] アイコンをクリックして、ユーザー選択ウィンドウ ダイアログボックスを開きます。まだ admin1 としてログオンしていることを確認します。
図 17 のように、Forms Auth を選択します。

図 17. 検索結果が表示されたユーザー選択ウィンドウ
図 17 のように検索ボックスに「bob」と入力し、[検索] をクリックします。1 レコードが返るはずです。
bob をダブルクリックして、[追加->] ボックスに追加します。
[OK] をクリックします。
手順 4. ～ 6. を繰り返して、ユーザー mary を追加します。
図 18 で示されているように、ドロップダウンボックスから [FBA Site Members] を選択します。

図 18. ユーザーへのアクセス許可の付与
[OK] をクリックします。
リボンで [アクセス許可の付与] をクリックします。
[参照] をクリックして、ユーザー選択ウィンドウを起動します。
前の図 17 と同じように、再び左側の Forms Auth を選択します。
検索ボックスに「ceo」と入力します。図 19 のように、1 レコードが返るはずです。

注意

この記事の例では、ceo は ASP.NET ロールプロバイダーのロールです。このロールは、手順 8. の最初に SQL クエリを使用して追加したものです。

図 19. ceo という名前のロールの検索
ceo をダブルクリックして、[アクセス許可の付与] ページに追加します。
図 20 のように、ロール ceo にフルコントロールアクセス許可を付与します。

図 20. ceo へのフルコントロールのアクセス許可の付与
図 21 のように、ページの右上隅の admin1 をクリックし、[別のユーザーとしてサインイン] を選択します。

図 21. 別のユーザーとしてサインイン

ユーザー bob およびユーザー mary としてサイトへのログオンを試みます。Web パーツにロールプロバイダーから正しいロールクレームが表示されることを確認してください。
jack としてログオンを試みます。ユーザー jack は次の 2 つのクレームを受け取ることに注意してください。

クレームの種類: https://schemas.microsoft.com/ws/2008/06/identity/claims/role

クレームの値: Admin

クレームの種類: https://schemas.microsoft.com/ws/2008/06/identity/claims/role

クレームの値: ceo

この 2 つのクレームは、事前に SQL クエリで割り当てたロールと一致します。ロール ceo にはアクセス許可を付与したので、ユーザーが ceo クレームを持っている場合は、サイトにログオンし、対応する権限を持つことができます。

まとめ

このチュートリアルでは、ASP.NET SQL のメンバーシッププロバイダーとロールプロバイダーを使用して、クレームベース Web アプリケーション用のフォームベース認証を作成する方法について説明しました。

その他の技術情報

詳細については、次のリソースを参照してください。

クレームに関するチュートリアル: ASP.NET SQL のメンバーシップ プロバイダーとロール プロバイダーを使用したクレーム ベースの SharePoint 2010 Web アプリケーション用のフォーム ベース認証の作成

ASP.NET SQL のメンバーシップ プロバイダーとロール プロバイダーによるクレーム ベース Web アプリケーションの認証の概要

手順 1: SharePoint Web アプリケーションの作成

SharePoint Web アプリケーションを作成するには

手順 2: Web アプリケーションに ASP.NET のメンバーシップおよびロール プロバイダーを使用するためのデータベースの準備

Web アプリケーションに ASP.NET メンバーシップ プロバイダーおよびロール プロバイダーを使用するようにデータベースを準備するには

手順 3: SharePoint Web アプリケーション用のメンバーシップとロール プロバイダーの構成

SharePoint Web アプリケーション用にメンバーシップ プロバイダーおよびロール プロバイダーを構成するには

手順 4: メンバーシップおよびロール プロバイダー データベースへのユーザーとロールの追加

メンバーシップおよびロールのプロバイダー データベースにユーザーとロールを追加するには

手順 5: フォーム ベース認証のテスト

フォーム ベースの認証をテストするには