identityProvider リソース タイプ (非推奨)

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

注意

この ID プロバイダー API は非推奨であり、2023 年 3 月以降はデータの返送を停止します。 新しい ID プロバイダー API を使用してください。

Microsoft Entra テナントと Azure AD B2C テナントの 外部 ID を 持つ ID プロバイダーを表します。

Microsoft Entra テナントの Microsoft Entra B2B シナリオの場合、ID プロバイダーの種類は Google または Facebook です。

Microsoft Entra テナントで ID プロバイダーを構成すると、新しい Microsoft Entra B2B ゲスト シナリオが有効になります。 たとえば、Gmail のユーザーと共有する必要がある Microsoft 365 のリソースが組織にあるとします。 Gmail ユーザーは、Google アカウントの資格情報を使用して、ドキュメントの認証とアクセスを行います。

Azure AD B2C テナントの ID プロバイダーの種類は、 Microsoft、 Google、 Facebook、 Amazon、 LinkedIn、 Twitter、または 任意の openIdConnectProvider です。 プレビューに表示されている ID プロバイダーは、Weibo、QQ、WeChat および GitHub です。

Azure AD B2C テナントで ID プロバイダーを構成すると、ユーザーはソーシャル アカウント、またはアプリケーションでカスタム OpenID Connect でサポートされているプロバイダーを使ってサインアップおよびサインインができます。 たとえば、アプリケーションで Azure AD B2C を使用することにより、ユーザーが Facebook アカウントまたはOIDC プロトコルに準拠した自身のカスタム ID プロバイダーを使用して、サービスにサインアップすることができます。

型として OpenIDConnect を持つカスタム OpenID Connect ID プロバイダーの場合は、このリソース の種類 から継承する openIdConnectProvider リソースの種類を使用して表されます。

メソッド

メソッド	戻り値の型	説明
List	identityProvider コレクション	テナントで構成されたすべての ID プロバイダーを取得します。
Create	identityProvider	新しい ID プロバイダーを作成します。
Get	identityProvider	ID プロバイダーのプロパティを取得します。
Update	なし	ID プロバイダーを更新します。
Delete	なし	ID プロバイダーを削除します。
利用可能な ID プロバイダーの種類の一覧	文字列コレクション	利用可能なすべての ID プロバイダーの種類を取得します。

プロパティ

プロパティ	型	説明
clientId	文字列	アプリケーションを 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 プロバイダーのサインイン ページでユーザーが資格情報を入力してサインインできるようになります。 Microsoft Entra ID は、テナントがアプリケーションにトークンを発行する前に、ID プロバイダーからトークンを検証します。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。 次の JSON 表現は、リソースの種類を示しています。

{
    "id": "String",
    "type": "String",
    "name": "String",
    "clientId": "String",
    "clientSecret": "String"
}