identityProvider リソース タイプ (非推奨)
名前空間: microsoft.graph
注意
この ID プロバイダー API は非推奨であり、2023 年 3 月以降はデータの返送を停止します。 新しい ID プロバイダー API を使用してください。
Microsoft Entra ID プロバイダーを表します。 ID プロバイダーは、Microsoft、Google、Facebook、Amazon、LinkedIn、Twitter のいずれかです。 次の ID プロバイダーはプレビュー段階です: Weibo、QQ、WeChat、GitHub および OpenID Connect をサポートするすべてのプロバイダー。
Azure AD B2C テナントで ID プロバイダーを構成すると、ユーザーは次のことができるようになります。
- ソーシャル アカウントを使用しての、コンシューマー向けアプリケーションでの新規登録およびサインイン。 たとえば、アプリケーションで Azure AD B2C を使用することにより、ユーザーが Facebook アカウントを使用してサービスにサインアップすることを可能にできます。
- コンシューマー向けアプリケーションでの、既存のローカル アカウントのソーシャル アカウントへの関連付け。 たとえば、ユーザーがアプリケーションでユーザー名とパスワード (ローカル アカウント) を作成したとします。 ユーザーは後から既存のローカル アカウントを自分の Facebook アカウントに関連付けることができ、Facebook を使用してサインインできるようになります。
Microsoft Entra テナントで ID プロバイダーを構成すると、今後の B2B ゲスト シナリオが可能になります。 たとえば、Gmail のユーザーと共有する必要がある Microsoft 365 のリソースが組織にあるとします。 Gmail ユーザーは、認証したりドキュメントにアクセスするのに Google アカウントの資格情報を使用します。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Get | identityProvider | 既存の identityProvider のプロパティのプロパティを確認します。 |
| Create | identityProvider | 新しい identityProvider を作成します。 |
| Update | なし | 既存の identityProvider を更新します。 |
| Delete | なし | 既存の identityProvider を削除します。 |
| List | identityProvider コレクション | テナント内で構成されているすべての identityProvider を一覧表示します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| clientId | String | アプリケーションのクライアント ID。 アプリケーションを ID プロバイダーに登録した際に取得したクライアント ID です。 必須です。 null 許容ではありません。 |
| clientSecret | String | アプリケーションでのクライアント シークレット。 アプリケーションを ID プロバイダーに登録した際に取得したクライアント シークレットです。 これは、書き込み専用です。 読み取り操作を行うと、**** が返されます。 必須です。 null 許容型ではありません。 |
| id | String | ID プロバイダーの ID。 |
| name | String | ID プロバイダーの表示名。 null 許容ではありません。 |
| type | String | ID プロバイダーの種類は必須フィールドです。 B2B シナリオの場合: Google、Facebook。 B2C シナリオの場合: Microsoft、Google、Amazon、LinkedIn、Facebook、GitHub、Twitter、Weibo、QQ、WeChat、OpenIDConnect。 null 許容ではありません。 |
クライアント ID とシークレットを取得する場所
各 ID プロバイダーには、アプリ登録を作成するためのプロセスがあります。 たとえば、ユーザーは Facebook とのアプリ登録を developers.facebook.com で作成します。 作成したクライアント ID とクライアント シークレットは、identityProvider を作成する に渡すことができます。 その後、認証のためにディレクトリ内の各ユーザー オブジェクトをいずれかのテナントの ID プロバイダーにフェデレーションすることができます。 これにより、ID プロバイダーのサインイン ページでユーザーが資格情報を入力してサインインできるようになります。 テナントがアプリケーションにトークンを発行する前に、ID プロバイダーからのトークンが Microsoft Entra ID によって検証されます。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"id": "String",
"type": "String",
"name": "String",
"clientId": "String",
"clientSecret": "String"
}