WIF

「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

戻る

目次 †

↑

概要 †

WIF:Windows Identity Foundation

Windows Identity Foundation の概要
https://msdn.microsoft.com/ja-jp/library/ee748475.aspx

Windows Identity Foundation (WIF) は、クレームベース認証に対応のアプリケーションを構築するためのフレームワークです。
このフレームワークは、WS-Trust プロトコルと WS-Federation プロトコルを抽象化し、
セキュリティトークンサービスと要求に対応したアプリケーションを構築するための API を開発者に提供します。
アプリケーションでは、WIF を使用して、STSから発行されたトークンを処理し、
RP（Web アプリケーションまたは Web サービス）でクレームベースの決定を下すことができます。

※ .NET Coreでは「Microsoft.AspNetCore.Authentication.WsFederation」を使用するもよう。

↑

Protocol †

↑

WS-FED †

サポートあリ。

アサーションはSAMLやJWTを選択可能。

.NETで使えるアイデンティティ連携のためのライブラリまとめ（後編） - Build Insider
http://www.buildinsider.net/web/msidentitydev/02
セキュリティ・フォーマットの処理について、前述したSAML AssertionはWIFで処理することが可能だが、
JWTについてはNuGetで配布されている「JSON Web Token Handler For the Microsoft .Net Framework 4.5」
（本執筆時点では開発者プレビュー版）を使用することで処理可能だ。

↑

SAML †

Extensionでサポートしているようですが、更新が、CTPで止まっているらしいです。

Understanding Windows Identity Foundation (WIF) 4.5 > SAML 2.0 - CodeProject?
https://www.codeproject.com/Articles/504399/Understanding-Windows-Identity-Foundation-WIF#7
WIF does not support SAML-P, although some time ago an extension to WIF that adds SAML 2.0 support was CTP’ed
but has not took off since then. Here you can see the announcement:

Working with SAML 2.0 in C# .NET 4.5 - Stack Overflow
https://stackoverflow.com/questions/15530184/working-with-saml-2-0-in-c-sharp-net-4-5
That's because Saml2Assertion refers to the token not the protocol.
The SAML token used in WIF is a 1.0 token.
There is no SAML 2 protocol support in .NET.
There is a WIF CTP for SAML 2 but it hasn't been upgraded for ages.

IdM実験室: [Azure/SAML]Azure Webアプリにお手軽テスト用SAML SPをデプロイする
http://idmlab.eidentity.jp/2015/04/azuresamlazure-websaml-sp.html
※WIFとかADALがちゃんとSAMLを喋れればいいんですが、
ws-federation/OpenID Connectなんで実はSAML SPってぽっかり穴が空いています。

↑

FedUtil? †

RPと STSとの間で信頼を簡単に確立できる。

↑

準備 †

↑

STS側の構築 †

STS（ADFS）側の構築を完了させておく。
STSのエンドポイントのFQDNとサーバ証明書のCN（Common Name）は一致させておく。

↑

前提ソフトウェアをインストール †

RPで以下の前提ソフトウェアをインストールする。

IIS
ASP.NET 3.5 and ASP.NET 4.5
.NET Framework 3.5 Features and Windows Identity Foundation 3.5 options.

↑

SDKのダウンロードとインストール †

RPでSDKのダウンロードとインストールをする。

Download the Windows Identity Foundation SDK
これは、サンプルのクレームベース認証アプリケーションを含みます。
http://www.microsoft.com/download/details.aspx?id=4451

WindowsIdentityFoundation?-SDK-4.0.msi ファイルを実行して、
Windows Identity Foundation SDK 4.0をデフォルトオプションでインストール。

↑

STS側のエンドポイントの証明書を検証 †

STS側の認証連携を行うHTTPSのエンドポイントの証明書が
自己証明書の場合、RPから以下の手順を実施して検証できる。

フェデレーション・メタデータを交換するSTSのHTTPSエンドポイントに
インターネット・エクスプローラーを使用してアクセスする。
証明書が自己証明書の場合、アドレスバーに証明書のエラーが表示されるのでこれをクリックする。
[証明書は信頼できません]ダイアログ・ボックスで[証明書の表示]を押下。
[証明書のインストール]ボタンを押下して以下のストアに証明書をインストールする。
- ストア：[ローカルコンピューター]の[信頼されたルート証明機関]

↑

サンプルのクレームベース認証アプリケーションをIIS配下でホスト †

以下のサンプルを利用可能

Windows Identity Foundation SDKに付属のサンプル。
https://github.com/OpenTouryoProject/SampleProgram/tree/master/ASPNET/AuthN_AuthZ/ID-Federation/ClaimsWeb_sample

↑

実行 †

WIFのインストール・ディレクトリに移動してFedUtil?.exeを実行する。

C:\Program Files (x86)\Windows Identity Foundation SDK\v4.0 folder.
FedUtil?.exeファイルをダブル・クリックして実行する。

Webアプリケーション・プロジェクトを右クリックし、
[Add STS reference]を選択でもFedUtil?.exeを実行可能なもよう。

↑

設定 †

↑

Welcome画面 †

[Application configuration location]テキスト・ボックス
WebアプリケーションのWeb.configを設定する。

[Application URI]テキスト・ボックス
WebアプリケーションのURL（仮想ディレクトリ）を設定する。

[Next]ボタンをクリック。

↑

[Security Token Service]画面 †

[Use an existing STS]オプション・ボタンを選択する。
STS WS-Federation metadata document locationテキスト・ボックスに入力
e.g. : https://[ADFSのFQDN名]/federationmetadata/2007-06/federationmetadata.xml