SSO と SCIM のエラーをトラブルシューティングする
このページで学べること
Klaviyoで、シングルサインオン(SSO)とクロスドメインID管理(SCIM)のエラーをトラブルシューティングする方法をご確認ください。この記事は、IT担当者など、SSOとSCIMに詳しい方向けです。
詳しくはシングルサインオンを設定する方法に関するこの記事をご覧ください。
エラーの一覧と修正方法
これらの表では、SSOおよびSCIMでよくあるエラーを取り上げています。情報が不足していたり、情報が正しくなかったりすると、エラーが発生しやすくなります。
KlaviyoのSSO設定を確認するには、設定>セキュリティに移動してください。シングルサインオン(SSO)の下で、接続を設定するためにSSOを設定または設定を編集をクリックしてください。SSO設定を使用して、SSO、IdP起点のログイン、またはJITプロビジョニングを有効にします。
エラー | 修正方法 |
{email}({company_id})の SSO 設定がありません | KlaviyoでSSOの設定を完了したら、保存をクリックしてください。 |
{email}({company_id})の SSO が無効になっています | Klaviyoで、SSO設定のSSOを有効にするを選択してください。 |
({company_id})の SSO 設定がありません | KlaviyoでSSOの設定を完了したら、保存をクリックしてください。 |
({company_id}) の SSO が無効になりました | Klaviyoで、SSO設定のSSOを有効にするを選択してください。 |
アカウント({company_id})で {email} の新しい SSO ユーザーをプロビジョニングできません(Just-in-Time プロビジョニングが有効になっていません) | SSOで初回ログインしたときにKlaviyoがユーザーを作成するようにするには、KlaviyoのSSO設定でジャストインタイム(JIT)プロビジョニングを選択してください。 |
{email}({company_id})の IdP-Initiated SSO は無効です | ユーザーがIdPからログインを開始できるようにするには、KlaviyoのSSO設定でIdP主導ログインを選択してください。 |
({company_id})の SSO 設定がありません | KlaviyoでSSOの設定を完了したら、保存をクリックしてください。 |
Klaviyoでの名前は{Klaviyo name}ですが、{IdP name}のSCIMメッセージと一致しません。 | 複数のKlaviyoアカウントに属しているユーザーについては、IdPの名と姓を更新してKlaviyoと一致させてください。または、Klaviyoで名前を更新してIdPと一致させるよう、ユーザーに依頼してください。その後、SCIM更新を再試行してください。 |
SSO 設定エラー
Klaviyoでは、署名付きのSAMLアサーションが必要です。レスポンスへの署名とアサーションの暗号化は、任意です。個別に暗号化された属性はサポートされていません。
エラー | 修正方法 | ||
未対応の SAML バージョン | IdP SSO プロバイダーに移動し、SAML 2.0 に更新してください。 | ||
SAML レスポンスの ID 属性がありません | IdPのSAMLレスポンス要素にID属性が含まれていることを確認してください。これはレスポンスの識別子であり、IdPの発行者やユーザーのメールアドレスではありません。 | ||
ロール属性が見つかりません | IdPで、SAMLアサーションのAttributeStatementにロール属性を含めてください。設定しているアカウントの種類にはロールを使用してください。静的なアカウントとポートフォリオのロール値は以下に示します。 JITプロビジョニングでは、オーナーまたはポートフォリオオーナーを作成したり、所有権を移行したりできません。既存のオーナーの場合、IdPから送信されるロールは、現在のオーナーロールと一致している必要があります。 | ||
|
| ||
SAML レスポンスには 1 つのアサーションが含まれている必要があります | IdPが各SAMLレスポンスでアサーションを正確に1つ送信するように設定してください。 | ||
無効な SAML レスポンス。saml-schema-protocol-2.0.xsd と一致しません | SAMLレスポンスがSAML 2.0スキーマに準拠していることを確認してください。 | ||
Assertion には Conditions 要素が含まれている必要があります。 | IdPのSAMLレスポンスアサーションにConditions要素が含まれていることを確認してください。 | ||
Assertion には AuthnStatement 要素を含める必要があります | IdP の SAML レスポンスアサーションに AuthnStatement 要素が含まれていることを確認してください。 | ||
レスポンスに EncryptedAttribute が含まれていますが、この SP はそれらをサポートしていません | Klaviyo では、属性が暗号化されている場合はサポートされません。IdP の設定を確認し、暗号化されている属性がないことを確認してください。 | ||
レスポンスの Destination 値が空です | IdPで、宛先をKlaviyoのSSOセットアップに表示されているKlaviyo SSO URLに設定してください。フィールド名はプロバイダーによって異なります。一般的な名前には、「Reply URL」、「ACS URL」、「Assertion Consumer Service URL」、「Trusted URL」、「エンドポイント URL」が含まれます。 | ||
%s は、このレスポンスに対して有効なオーディエンスではありません | SSO 設定パネルで提供される Audience URI(Service Provider Entity ID)(https:// プレフィックスを含む)と、IdP 内の audience Id が完全に一致していることを確認してください。 | ||
Invalid issuer in the Assertion/Response (expected %(idpEntityId)s, got %(issuer)s) | KlaviyoのSSO設定で、IdP IssuerがIdPのSAMLレスポンス内のIssuer(エンティティID)と一致していることを確認し、Saveをクリックします。 | ||
属性は、この Response の AttributeStatement の SessionNotOnOrAfter に基づいて期限切れになりました | ログインを再試行してください。それでも解決しない場合は、IdP で SAML レスポンスの有効期限ウィンドウを延長してください。短すぎる可能性があります。 | ||
この Response に有効な SubjectConfirmation が見つかりませんでした | アサーションに、bearerメソッドの有効なSubjectConfirmationとSubjectConfirmationDataが含まれていることを確認します。recipientがKlaviyo SSO URLと一致していること、有効期間に現在時刻が含まれていること、またInResponseToの値がある場合はレスポンスと一致していることを確認します。 | ||
レスポンスのアサーションが署名されておらず、SP で必要です。 | IdPで、SAMLアサーションの署名を有効にしてください。 サポートが必要な場合は、IdP にお問い合わせください。 | ||
署名が見つかりません。SAML レスポンスが拒否されました | IdPがSAMLアサーションに署名するようにしてください。レスポンスのみに署名しても、Klaviyoのアサーション署名要件は満たされません。 | ||
署名の検証に失敗しました。SAML レスポンスが拒否されました | KlaviyoのSSO設定で、IdP証明書が、IdPがSAMLアサーションに署名するために使用している証明書と一致していることを確認してください。変更内容を保存し、その後SSOをもう一度テストしてください。 | ||
SAML レスポンスが見つかりません。サポートされているのは HTTP_POST バインディングのみです | IdP が HTTP_POST リクエストを送信していることを確認してください。 | ||
SSOエラーを修正したら、KlaviyoのSSO設定に戻り、SSOをテストをクリックしてください。これにより、接続設定が保存され、ログインが再度テストされます。
その他のトラブルシューティングのヒント
該当する問題に最も近いドロップダウンを開き、解決方法に関する情報を確認してください。
Klaviyo でユーザーのロールを編集できません。
SSOとジャストインタイム(JIT)プロビジョニングが有効になっている場合、またはSCIMが有効になっている場合、ユーザーのロールはIdPを通じて管理されます。SSOの例外リストに含まれるユーザーは、Klaviyoで引き続きロールを変更できます。
IdPでユーザーのロールを更新します。JITは、ユーザーが次回SSOでログインしたときにロールを適用します。SCIMがオフで、Klaviyoで直接ロールを変更する必要がある場合は、次の手順を使用します:
- 設定 > セキュリティで、SSO設定のJust-in-time(JIT)プロビジョニングをクリアし、確認のために無効化をクリックします。
- Klaviyoでユーザーのロールを更新します。JITを再度有効にしたときに変更内容が上書きされないよう、IdPでも同じロールを設定してください。
- 再度Just-in-time(JIT)プロビジョニングを選択して、オンに戻してください。
免除リストを表示できません
除外リストを表示するには、SSO を設定しておく必要があります。手順については、Klaviyo で SSO を有効にする方法に関する記事をご覧ください。
その他のリソース
- シングルサインオン(SSO)の設定方法
Klaviyo アカウントまたはポートフォリオ向けにシングルサインオン(SSO)を設定する方法をご確認ください。現在、Klaviyo では ID プロバイダー(IdP)シングルサインオンのみがサポートされています。
- 多要素認証(MFA)の設定方法
Klaviyo アカウントやポートフォリオの安全性を強化できる MFA の設定方法について、学びましょう。MFA を有効にすると、ユーザー名とパスワードを使ってログインし、コード入力などによって本人確認を行います。
- SCIM ユーザー プロビジョニングを設定する方法
アカウントまたはポートフォリオで、クロスドメイン ID 管理(SCIM)ユーザープロビジョニングのシステムを設定する方法をご確認ください。