この記事では、既存のSAML SSOの設定において、URLまたはXMLファイルを使用してメタデータを更新する方法、あるいはPEMファイルを使用して証明書を更新する方法について説明します。組織管理者であれば、いつでもこれらの更新を行うことができます。
既存の設定を更新するのではなく、初めてSAML SSOを設定する場合は、「SAMLシングルサインオン(SSO)を設定する」をご参照ください。
始める前に
- 組織のSAML設定を更新するには、組織管理者である必要があります。サブスクリプション管理者には、この操作を行う権限がありません。組織ユーザーの詳細をご覧ください。
- 新しい構成の詳細(IDプロバイダーのメタデータURL、メタデータXMLファイル、またはPEM証明書ファイル)を準備してください。
- SAML SSOがサブスクリプションの唯一のサインイン方法であるかどうかを確認します。これを行うには、 [設定(Settings)]>[サブスクリプション設定(Subscription Settings)] の順に進み、 [セキュリティとプライバシー(Security and privacy)] セクションまでスクロールします。[サインイン方法(Sign-in methods)]の下にSAML SSOのみが一覧表示されているかどうかを確認できます。表示されている場合、メールアドレスとパスワードによるフォールバックがないため、次のセクションで開始するアクティブなセッションが設定に戻る唯一の方法になります。
ステップ1:新しいセッションを開始する
変更を行う前に、Pendoからログアウトして再度ログインし、新しいアクティブなセッションを開始します。SAMLの変更によって誤ってサインインできなくなった場合でも、このアクティブなセッションを使用して設定に戻り、修正できます。
ステップ2:SAML設定を更新する
SAML設定は、組織設定から更新できます。メニューにこのオプションが表示されない場合は、組織管理者権限がない可能性があります。詳細については、組織ユーザーを参照してください。
- 右上のメニューから、[設定(Settings)]>[組織設定(Organization settings)]に移動します。
- [SSO]タブを選択します。
- 左側のオプションから[SAML]を選択します。
- 更新するSAML設定を選択します。これを行うには、リスト内の名前を選択するか、行の上にカーソルを合わせて編集アイコンを選択します。
-
メタデータを更新する方法、または証明書を置き換える方法を選択します。3つのオプションがあります。
タイプ 詳細 URL
IDプロバイダーのメタデータのURLがある場合は、これを使用します。このオプションを選択すると、URLを入力できるテキストフィールドが開きます。 メタデータ(XML) メタデータを含むXMLファイルがある場合は、これを使用します。このオプションを選択すると、. xml拡張子のファイルをアップロードするオプションが表示されます。証明書(PEM) 証明書のPEMファイルをお持ちの場合は、これを使用してください。このオプションを選択すると、 .pem拡張子のファイルをアップロードするオプションが表示されます。 - 完了したら、[設定を保存]を選択して新しいSAML設定をすぐに適用します。
- このページは開いたままにしてください。変更を検証する際にSSOで問題が発生した場合、正常に動作していない箇所を修正するためにこれが必要になることがあります。
注:新しい証明書情報が有効であり、アップロードしたメタデータが正確に一致していることを、IDプロバイダーに確認してください。編集内容を保存すると、以前の設定に戻すことはできません。
ステップ3:変更を確認する
すぐに変更内容を確認してください。これにより、ユーザーがロックアウトされるのを防ぎます。
- ログインしていない状態にするため、シークレットウィンドウ、プライベートモード、または普段使用しているブラウザとは異なるブラウザを開いてください。
- ログイン画面のSSOオプションを使用してPendoにサインインします。
証明書の更新内容が正しい場合、エラーが発生することなくSSO経由でログインできます。
サインインに関する問題のトラブルシューティング
変更内容を確認する際にエラーが発生した場合は、作業を行っていたブラウザ(ステップ7)に戻り、メタデータまたは証明書が正しく入力されていることを確認してください。修正する前にロックアウトされないよう、アクティブなセッションが期限切れになる前にすぐに行ってください。
設定を修正してもサインインが復元されない場合は、Pendoサポートにお問い合わせください。
重要:SAML SSOがサブスクリプションの唯一のサインイン方法である場合、ユーザーはメールアドレスとパスワードを使用してログインすることはできません。問題が修正されるまで、ロックアウトされます。