WCF: SharePoint 2010 外部コンテンツタイプとしてのクレーム対応 WCF Web サービスの利用 (パート 4 / 4)

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

概要: SharePoint Designer 2010 を使用してクレーム対応の Web サービスを利用する方法を説明します。この記事はシリーズの 4 番目にあたります。この記事の手順に従う前に、まずこれまでの 3 つの記事の手順を確認して実行してください。

最終更新日: 2011年11月4日

SharePoint Online で使用可能

この記事の内容
概要
Web サービスからの外部コンテンツタイプの作成
まとめ
その他の技術情報

提供元: Eric White、Microsoft Corporation | Saji Varkey、Microsoft Corporation | Bin Zhang、Microsoft Corporation

概要
Web サービスからの外部コンテンツタイプの作成
まとめ
その他の技術情報

この記事は、Microsoft Business Connectivity Services (BCS) を使用したクレーム対応 Web サービスの作成および利用方法を 4 部構成で説明するシリーズの 4 番目の記事です。

概要

クレーム対応 Web サービスを外部コンテンツタイプとして利用する方法は、クレームに対応していない Web サービスを外部コンテンツタイプとして使用する場合と類似しています。既に外部コンテンツタイプの設定に習熟している場合は、この手順のほとんどのステップに見覚えがあるはずです。クレームの使用に特有の手順は、ステップ 28、29、および 30 のみです。

Web サービスからの外部コンテンツタイプの作成

Web サービスから外部コンテンツタイプを作成するには

Microsoft SharePoint Designer 2010 を開きます。
外部コンテンツタイプを使用するように構成した SharePoint サイトを開きます。
[サイトオブジェクト] リストで、[外部コンテンツタイプ] をクリックします。

図 1. サイトオブジェクトリストの外部コンテンツタイプ
リボンの [新しい外部コンテンツタイプ] をクリックします。

図 2. リボンの外部コンテンツタイプ
[新しい外部コンテンツタイプ] タブで、[新しい外部コンテンツタイプ] をクリックします。

図 3. 新しい外部コンテンツタイプリンク
外部コンテンツタイプの名前を入力します。たとえば、顧客の名前を入力します。

図 4. 外部コンテンツタイプの名前付け
Tab キーを押します。

Tab キーを押すと、SharePoint Designer 2010 によって [表示名] が [名前] と同じものに設定されます。必要に応じて、[表示名] を [名前] とは異なるものに変更できます。
[ここをクリックして、外部データソースの検出と操作の定義を行います。] リンクをクリックします。

図 5. 外部データソースの検出
[接続の追加] をクリックします。

図 6. 接続の追加
[外部データソースの種類の選択] ダイアログボックスが表示されます。

リストから [WCF サービス] を選択し、[OK] をクリックします。
[WCF 接続] ダイアログボックスの [サービスメタデータの URL] フィールドに、このシリーズの前の記事で作成した Web サービスのサービスメタデータの URL を入力します。このメタデータの URL は、次のようになります。サーバー名は、前の記事「WCF: WCF Web サービスと SharePoint 2010 Security Token Service 間の信頼関係の確立 (パート 3/4)」の手順「証明書の HTTPS へのバインド」で決定した件名フィールドの値で置き換えられています。
```
http:// ericwhit209.redmond.corp.microsoft.com/Customers/Customers.svc?wsdl
```
図 7. サービスメタデータの URL の入力

注意

このメタデータの URL では https が使用されていないことに注意してください。
[サービスエンドポイントの URL] に Web サービスのサービスエンドポイントの URL を入力します。サービスエンドポイントの URL は次のようになります。サーバー名は、ドメイン内の完全修飾コンピューター名で置き換えられています。
```
https:// ericwhit209.redmond.corp.microsoft.com/Customers/Customers.svc
```
図 8. サービスエンドポイント URL の入力
「顧客」と [名前 (省略可能)] フィールドに入力します。

図 9. 接続名の入力
[OK] をクリックします。SharePoint Designer による Web サービスの検出中は、1 つ以上の進捗状況バーが表示されます。
[データソースエクスプローラー] で [顧客] データソースノードを展開します。

図 10. 顧客データソースの展開
[データソースエクスプローラー] で [Web メソッド] ノードを展開します。

図 11. Web メソッドの展開
[GetAllCustomers] を右クリックし、["リストの読み取り" 操作の新規作成] をクリックします。

図 12. リストの読み取り操作の新規作成
ウィザードの [操作のプロパティ] ダイアログで、[次へ] をクリックします。
ウィザードの [入力パラメーター構成] ダイアログで、[次へ] をクリックします。
ウィザードの [戻り値パラメーター構成] ダイアログにある [データソース要素] ツリーで、[CustomerID] をクリックします。[プロパティ] で、[識別子へのマップ] チェックボックスをクリックします。

図 13. [識別子へのマップ] のクリック

[完了] をクリックします。
[データソースエクスプローラー] で、[GetCustomerByID] を右クリックし、["リストの読み取り" 操作の新規作成] をクリックします。

図 14. "リストの読み取り" 操作の新規作成
ウィザードの [操作のプロパティ] ダイアログで、[次へ] をクリックします。
ウィザードの [入力パラメーター構成] ダイアログで、[データソース要素] の [CustomerID] をクリックし、[プロパティ] の [識別子へのマップ] チェックボックスをクリックします。

図 15. 識別子へのマップ

[次へ] をクリックします。
ウィザードの [戻り値パラメーター構成] ダイアログで、[データソース要素] の [CustomerID] をクリックし、[プロパティ] の [識別子へのマップ] チェックボックスをクリックします。

図 16. 識別子へのマップ

[完了] をクリックします。
ツールバーの [保存] をクリックします。SharePoint Designer によって外部コンテンツタイプが保存されます。

図 17. [保存] のクリック
リボンの [リストとフォームの作成] をクリックします。

図 18. [リストとフォームの作成] のクリック
[Customer のリストおよびフォームの作成] ダイアログボックスの [リスト名] フィールドに「Customers」と入力します。[OK] をクリックします。

図 19. [リスト名] フィールドに「Customers」と入力
次に、以前作成した外部コンテンツタイプに対してクレームを有効にする必要があります。ナビゲーションウィンドウの [顧客] (コンテンツタイプ名) をクリックします。

図 20. 顧客への移動
リボンの [接続プロパティの編集] をクリックします。

図 21. [接続プロパティの編集] のクリック
[接続のプロパティ] ダイアログボックスで [クレームベース認証を使用します] をクリックします。[OK] をクリックします。

図 22. [接続のプロパティ] ダイアログボックス
次に、以前作成した外部コンテンツタイプの適切なアクセス許可を割り当てる必要があります。SharePoint Foundation 2010 を実行しているコンピューターで、[SharePoint サーバーの全体管理] を起動します。
[アプリケーション構成の管理] で [サービスアプリケーションの管理] をクリックします。
[サービスアプリケーション] ページで [Business Data Connectivity Service] をクリックします。

図 23. SharePoint サーバーの全体管理のサービスアプリケーション
以前作成したコンテンツタイプの横にあるチェックボックスをクリックし、[オブジェクトの権限の設定] をクリックします。

図 24. オブジェクトの権限の設定
[オブジェクトの権限の設定] ダイアログボックスで、アクセス許可を設定するユーザーのエイリアスを、アカウントまたはグループを追加できるフィールドに入力します。私の場合は、自分のエイリアス「ericwhit」を入力します。[名前の確認]、[追加] の順にクリックします。

図 25. エイリアスの入力と名前の確認
[追加] をクリックした後は、そのユーザーにこのコンテンツタイプに対するすべてのアクセス許可を付与します。

図 26. ユーザーのアクセス許可の指定
[オブジェクトの権限の設定] ダイアログボックスで、アカウントまたはグループを追加できるフィールドに「すべての認証されたユーザー」と入力します。[名前の確認]、[追加] の順にクリックします。

図 27. エイリアスの入力と名前の確認
[実行] チェックボックスをクリックして、認証されたユーザーに外部コンテンツタイプに対する実行アクセス許可を付与します。[OK] をクリックします。

図 28. 認証されたユーザーのアクセス許可の指定

これで、外部コンテンツタイプがクレームベース認証を使用するように正しく設定されました。
ブラウザーを使用して、SharePoint サイトを閲覧します。[顧客] リストを開くと、外部コンテンツタイプによって Web サービスから取得されたデータが表示されるはずです。

図 29. Web サービスからの取得データが含まれる外部リスト
最後の手順として、Web サービスが ID クレームにアクセスできること、またその ID クレームが正しく返されることを検証できます。Web サービスをホストしているコンピューターで、ログファイル C:\MyWebService\log.txt を開きます。このログファイルには、外部コンテンツタイプの直近のアクセスを示すエントリが含まれているはずです。また、リストにアクセスしたユーザーの ID を確認できます。この ID はクレームから取得されたものです。

図 30. クレームから取得された ID

ID をクレームとして取得すると、ID の前に "0#.w|" という文字列が追加されます。これは、エンコードされた SharePoint ID クレーム値です。このプレフィックスは、Windows クレームプロバイダーによって発行されたものであることを示します。

まとめ

このシリーズの記事では、クレームを使用する Web サービスを作成しました。また、この Web サービスを利用するように Business Connectivity Services を構成できました。追加のユーザー操作なしに、またユーザー資格情報を Secure Store に保存することなく、元のユーザー ID を Web サービスでも利用できるようにしました。この Web サービスでは、クレームを参照し、そのクレームに基づいて、保護されたリソースへのアクセス権を付与できます。

これらの記事では、クレームを使用する Web サービスへの接続の基本事項のみを説明しました。より高度なシナリオでは、Web サービスによってセキュリティグループ情報にクレームとしてアクセスし、そのセキュリティグループに基づいて特定のリソースへのアクセス権を付与することもできます。

Web サービスに対するクレームベース認証により、セキュリティで保護された方法で他のリソースにアクセスするように SharePoint Foundation 2010 または SharePoint Server 2010 を構成した場合に通常見られるダブルホップの問題は解消されます。

その他の技術情報

デベロッパーセンター:「SharePoint デベロッパーセンター」
ブログ: 「Eric White's Blog (英語)」
ブログ: 「Business Connectivity Services Team Blog (英語)」
ダウンロード: 「Microsoft .NET Framework 3.0 再頒布可能パッケージ」
ダウンロード: 「Installing IIS (英語)」

Share via

WCF: SharePoint 2010 外部コンテンツタイプとしてのクレーム対応 WCF Web サービスの利用 (パート 4 / 4)

概要

Web サービスからの外部コンテンツタイプの作成

Web サービスから外部コンテンツタイプを作成するには

まとめ

その他の技術情報

その他のリソース

Share via

WCF: SharePoint 2010 外部コンテンツ タイプとしてのクレーム対応 WCF Web サービスの利用 (パート 4 / 4)

概要

Web サービスからの外部コンテンツ タイプの作成

Web サービスから外部コンテンツ タイプを作成するには

まとめ

その他の技術情報

その他のリソース

WCF: SharePoint 2010 外部コンテンツタイプとしてのクレーム対応 WCF Web サービスの利用 (パート 4 / 4)

Web サービスからの外部コンテンツタイプの作成

Web サービスから外部コンテンツタイプを作成するには