次の方法で共有


internalDomainFederation リソースの種類

名前空間: microsoft.graph

重要

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

Microsoft Entra IDでフェデレーションおよび検証されるテナント内のドメインの構成を表します。 このリソースを使用して、Microsoft Entra IDとのフェデレーションを設定するときにフェデレーション設定を構成します。 フェデレーションの詳細については、「Microsoft Entra IDとのフェデレーションとは」を参照してください。

samlOrWsFedProvider から継承します。

メソッド

メソッド 戻り値の種類 説明
List internalDomainFederation コレクション ドメインの internalDomainFederation オブジェクトのプロパティを読み取ります。
Create internalDomainFederation 新しい internalDomainFederation オブジェクトを 作成します。
Get internalDomainFederation internalDomainFederation オブジェクトのプロパティとリレーションシップを読み取ります。
Update internalDomainFederation internalDomainFederation オブジェクトのプロパティを更新します。
Delete なし internalDomainFederation オブジェクトを削除します。

プロパティ

プロパティ 説明
activeSignInUri String Microsoft Entra IDでのシングル サインオン用に設定されたフェデレーション ドメインを使用して認証するときに、アクティブなクライアントによって使用されるエンドポイントの URL。 Set-MsolDomainFederationSettings MSOnline v1 PowerShell コマンドレットActiveLogOnUri プロパティに対応します。
displayName String フェデレーション ID プロバイダー (IdP) の表示名。 identityProviderBase から継承されます。
federatedIdpMfaBehavior federatedIdpMfaBehavior フェデレーション ユーザーが MFA を必要とする条件付きアクセス ポリシーによって管理されるアプリケーションにアクセスするときに、フェデレーション IdP によって実行される MFA をMicrosoft Entra IDが受け入れるかどうかを決定します。 使用可能な値: acceptIfMfaDoneByFederatedIdpenforceMfaByFederatedIdprejectMfaByFederatedIdpunknownFutureValue。 詳細については、「 federatedIdpMfaBehavior 値」を参照してください。
id String フェデレーション ID プロバイダーの識別子。 エンティティから継承 されます。
isSignedAuthenticationRequestRequired ブール型 true場合、SAML 認証要求がフェデレーション SAML IdP に送信されるときに、Microsoft Entra IDは OrgID 署名キーを使用してそれらの要求に署名します。 false (既定値) の場合、フェデレーション IdP に送信される SAML 認証要求は署名されません。
issuerUri String フェデレーション サーバーの発行者 URI。 samlOrWsFedProvider から継承されます。
metadataExchangeUri String リッチ クライアント アプリケーションからの認証に使用されるメタデータ交換エンドポイントの URI。 samlOrWsFedProvider から継承されます。
nextSigningCertificate String プライマリ署名証明書の有効期限が切れた場合など、トークンの署名にも使用できるフォールバック トークン署名証明書。 フェデレーション IdP のトークン署名証明書のパブリック部分の Base64 でエンコードされた文字列として書式設定されます。 X509Certificate2 クラスと互換性がある必要があります。 signingCertificate と同様に、自動ロールオーバー更新プログラムの外部でロールオーバーが必要な場合、新しいフェデレーション サービスが設定されている場合、またはフェデレーション サービス証明書が更新された後に新しいトークン署名証明書がフェデレーション プロパティに存在しない場合は、nextSigningCertificate プロパティが使用されます。
passiveSignInUri String Microsoft Entra サービスにサインインするときに Web ベースのクライアントが転送する URI。 samlOrWsFedProvider から継承されます。
passwordResetUri String クライアントが自分のパスワードをリセットするためにリダイレクトされる URI。
preferredAuthenticationProtocol authenticationProtocol 優先認証プロトコル。 フェデレーションパッシブ認証フローを機能させるには、このパラメーターを明示的に構成する必要があります。 使用可能な値: wsFedsamlunknownFutureValuesamlOrWsFedProvider から継承されます。
promptLoginBehavior promptLoginBehavior サインイン プロンプトの推奨動作を設定します。 使用可能な値: translateToFreshPasswordAuthenticationnativeSupportdisabledunknownFutureValue
signingCertificate String Microsoft ID プラットフォームに渡されるトークンの署名に使用される現在の証明書。 証明書は、フェデレーション IdP のトークン署名証明書のパブリック部分の Base64 でエンコードされた文字列として書式設定され、X509Certificate2 クラスと互換性がある必要があります。
このプロパティは、次のシナリオで使用されます。
  • 自動ロールオーバー更新プログラムの外部でロールオーバーが必要な場合
  • 新しいフェデレーション サービスが設定されている
  • フェデレーション サービス証明書が更新された後に、新しいトークン署名証明書がフェデレーション プロパティに存在しない場合。
    Microsoft Entra IDは、現在の証明書の有効期限が切れる 30 日前に、フェデレーション サービスメタデータから新しい証明書を取得しようとする自動登録プロセスを介して証明書を更新します。 新しい証明書が使用できない場合、Microsoft Entra IDはメタデータを毎日監視し、新しい証明書が使用可能になるとドメインのフェデレーション設定を更新します。 samlOrWsFedProvider から継承されます。
  • signingCertificateUpdateStatus signingCertificateUpdateStatus 署名証明書の最後の更新の状態とタイムスタンプを提供します。
    signOutUri String クライアントがMicrosoft Entra サービスからサインアウトするときにリダイレクトされる URI。 Set-MsolDomainFederationSettings MSOnline v1 PowerShell コマンドレットのLogOffUri プロパティに対応します。

    注:

    Azure AD および MSOnline PowerShell モジュールは、2024 年 3 月 30 日の時点で非推奨となりました。 詳細については、 非推奨の更新プログラムに関するページを参照してください。 この日付以降、これらのモジュールのサポートは、Microsoft Graph PowerShell SDK への移行支援とセキュリティ修正に限定されます。 非推奨のモジュールは、2025 年 3 月 30 日まで引き続き機能します。

    Microsoft Entra ID (旧称 Azure AD) と対話するには、Microsoft Graph PowerShell に移行することをお勧めします。 移行に関する一般的な質問については、移行に関する FAQ を参照してください。 手記: バージョン 1.0.x の MSOnline では、2024 年 6 月 30 日以降に中断が発生する可能性があります。

    federatedIdpMfaBehavior 値

    メンバー 説明
    acceptIfMfaDoneByFederatedIdp Microsoft Entra IDは、フェデレーション ID プロバイダーによって実行される MFA を受け入れます。 フェデレーション ID プロバイダーが MFA を実行しなかった場合、Microsoft Entra IDは MFA を実行します。
    enforceMfaByFederatedIdp Microsoft Entra IDは、フェデレーション ID プロバイダーによって実行される MFA を受け入れます。 フェデレーション ID プロバイダーが MFA を実行しなかった場合、MFA を実行するための要求がフェデレーション ID プロバイダーにリダイレクトされます。
    rejectMfaByFederatedIdp Microsoft Entra IDは常に MFA を実行し、フェデレーション ID プロバイダーによって実行される MFA を拒否します。

    注:federatedIdpMfaBehavior は、Set-MsolDomainFederationSettings MSOnline v1 PowerShell コマンドレットSupportsMfa プロパティの進化したバージョンです。

    • federatedIdpMfaBehaviorSupportsMfa の切り替えはサポートされていません。
    • federatedIdpMfaBehavior プロパティが設定されると、Microsoft Entra IDは SupportsMfa 設定を無視します。
    • federatedIdpMfaBehavior プロパティが設定されていない場合、Microsoft Entra ID引き続き SupportsMfa 設定が適用されます。
    • federatedIdpMfaBehaviorSupportsMfa も設定されていない場合は、既定Microsoft Entra ID動作acceptIfMfaDoneByFederatedIdp設定されます。

    リレーションシップ

    なし。

    JSON 表記

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

    {
      "@odata.type": "#microsoft.graph.internalDomainFederation",
      "id": "String (identifier)",
      "displayName": "String",
      "issuerUri": "String",
      "metadataExchangeUri": "String",
      "signingCertificate": "String",
      "passiveSignInUri": "String",
      "preferredAuthenticationProtocol": "String",
      "activeSignInUri": "String",
      "signOutUri": "String",
      "promptLoginBehavior": "String",
      "isSignedAuthenticationRequestRequired": "Boolean",
      "nextSigningCertificate": "String",
      "signingCertificateUpdateStatus": {
        "certificateUpdateResult": "String",
        "@odata.type": "microsoft.graph.signingCertificateUpdateStatus"
      },
      "federatedIdpMfaBehavior": "String",
      "passwordResetUri": "String"
    }