RTCPeerConnection: idpLoginUrl プロパティ

idpLoginUrl は RTCPeerConnection インターフェイスの読み取り専用プロパティで、アプリケーションがアイデンティティプロバイダー (IdP) へのユーザーログインを行うために開くことができる URL エンドポイントを含む文字列を返します。この値は、IdP がログインが必要であることを示すまでは null です。

IdP がユーザー認証を要求しているため、RTCPeerConnection.getIdentityAssertion() の呼び出しが失敗した場合、結果として返されるプロミスは RTCError によって拒否され、その errorDetail は "idp-need-login" となります。その後、ブラウザーはこのプロパティを、IdP から指定されたログイン URL に設定します。アプリケーションはこの URL を開くことができる（例えば、ポップアップウィンドウや <iframe> などで）、ユーザーがログインプロセスを完了してから、ID アサーションを再試行することができます。

const pc = new RTCPeerConnection();
pc.setIdentityProvider("login.example.com");

pc.getIdentityAssertion().catch((error) => {
  if (pc.idpLoginUrl) {
    console.log(`IdP login required at: ${pc.idpLoginUrl}`);
    // Open the login page in a popup window
    const loginWindow = window.open(
      pc.idpLoginUrl,
      "idp-login",
      "width=500,height=600",
    );
  } else {
    console.error("ID アサーションに失敗しました:", error);
  }
});