SSO と SCIM のエラーをトラブルシューティングする
このページで学べること
Klaviyo でシングルサインオン(SSO)のエラーをトラブルシューティングする方法をご確認ください。この記事は、IT 担当者など、SSO に詳しい方向けです。
詳しくはシングルサインオンを設定する方法に関するこの記事をご覧ください。
エラーの一覧と修正方法
SSO の設定時に発生し得るすべての潜在的なエラーについて解説します。情報が不足していたり誤っていたりすると、エラーが発生しがちです。
以下の表は、発生する可能性のあるすべてのエラー、修正する場所、修正方法を示しています。
エラー | 修正方法 |
{email}({company_id})の SSO 設定がありません | SSO の設定が Klaviyo に保存されていることを確認してください。 |
{email}({company_id})の SSO が無効になっています | Klaviyo の SSO 設定パネルで SSO を有効にします。 |
({company_id})の SSO 設定がありません | SSO 構成設定が保存されていることを確認してください。 |
({company_id}) の SSO が無効になりました | Klaviyo の SSO 設定パネルで SSO を有効にします。 |
アカウント({company_id})で {email} の新しい SSO ユーザーをプロビジョニングできません(Just-in-Time プロビジョニングが有効になっていません) | Just-in-Time ユーザー プロビジョニングを使用する場合は、IdP SSO プロバイダーの SSO 設定パネルでオンにしてください。 |
{email}({company_id})の IdP-Initiated SSO は無効です | IdP 開始 SSO を使用する場合は、SSO 設定パネルで有効にできます。 |
({company_id})の SSO 設定がありません | SSO の設定が構成され、保存されていることを確認してください。 |
このユーザーは Klaviyo で複数(1 社以上)の会社に所属しています。Klaviyo に登録されている名または姓が、提供された値と異なります。このユーザーに連絡し、IdP 内の名前を Klaviyo の値と一致するように更新してください。 | 管理者は、ユーザーの名前が IdP の情報と一致しない場合、ユーザーに名前の更新を依頼する必要があります。 |
SSO 設定エラー
エラー | 修正方法 | ||
未対応の SAML バージョン | IdP SSO プロバイダーに移動し、SAML 2.0 に更新してください。 | ||
SAML レスポンスの ID 属性がありません | IdP 設定に正しい ID が入力されていることと、形式が正しいことを確認してください。 | ||
ロール属性が見つかりません | SSO プロバイダーに移動し、SAML アサーションに role 属性を含めるようにしてください。Role 値は、次のいずれかである必要があります。 | ||
|
| ||
SAML レスポンスには 1 つのアサーションが含まれている必要があります | SSO プロバイダーに移動し、SAML アサーションにロール属性が含まれていることを確認してください。 | ||
無効な SAML レスポンス。saml-schema-protocol-2.0.xsd と一致しません | SAML レスポンスが SAML 2.0 のスキーマ プロトコルに準拠していることを確認してください。 | ||
Response のアサーションは暗号化されておらず、SP ではそれが必要です | Klaviyo では、アサーションを暗号化する必要があります。暗号化されたアサーションを使用していることを確認してください。 | ||
Assertion には Conditions 要素が含まれている必要があります。 | IdP の SAML 応答アサーションに conditions 要素が含まれていることを確認してください。 | ||
Assertion には AuthnStatement 要素を含める必要があります | IdP の SAML レスポンスアサーションに AuthnStatement 要素が含まれていることを確認してください。 | ||
レスポンスに AttributeStatement がありません | IdP の SAML レスポンスアサーションに AttributeStatement 要素が含まれていることを確認してください。 | ||
レスポンスに EncryptedAttribute が含まれていますが、この SP はそれらをサポートしていません | Klaviyo では、属性が暗号化されている場合はサポートされません。IdP の設定を確認し、暗号化されている属性がないことを確認してください。 | ||
レスポンスの Destination 値が空です | IdP に移動して、宛先を入力します。この値の名前は “destination” ではない場合があることに注意してください。名前は異なることがあります。“destination” が表示されない場合は、この値に対する他の一般的な名前を探してください:“Reply URL”、“ACS URL”、“Assertion Consumer Service URL”、“Trusted URL”、“Endpoint 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) | SSO 管理パネルの IdP SSO URL フィールドが、ID プロバイダーから提供された SSO URL と一致していることを確認してください | ||
属性は、この Response の AttributeStatement の SessionNotOnOrAfter に基づいて期限切れになりました | ログインを再試行してください。それでも解決しない場合は、IdP で SAML レスポンスの有効期限ウィンドウを延長してください。短すぎる可能性があります。 | ||
この Response に有効な SubjectConfirmation が見つかりませんでした | IdP の設定を確認し、件名確認方法を探します。正しくフォーマットされていることを確認してください。 | ||
レスポンスのアサーションが署名されておらず、SP で必要です。 | 以下のいずれかを行います。
サポートが必要な場合は、IdP にお問い合わせください。 | ||
The Message of the Response is not signed and the SP require it | 以下のいずれかを行います。
サポートが必要な場合は、IdP にお問い合わせください。
| ||
署名が見つかりません。SAML レスポンスが拒否されました | IdP からの SAML メッセージが適切に署名されていることを確認してください。 | ||
署名の検証に失敗しました。SAML レスポンスが拒否されました | ワークスペースの SSO ページに移動し、証明書が IdP から送信された証明書と一致していることを確認してください。 | ||
SAML レスポンスが見つかりません。サポートされているのは HTTP_POST バインディングのみです | IdP が HTTP_POST リクエストを送信していることを確認してください。 | ||
その他のトラブルシューティングのヒント
該当する問題に最も近いドロップダウンを開き、解決方法に関する情報を確認してください。
Klaviyo でユーザーのロールを編集できません。
この原因として最も考えられるのは、ジャストインタイム(JIT)プロビジョニングを使用している場合です。JIT がオンの場合、Klaviyo でユーザーのロールを編集できません。
そのための最適な方法は、次のとおりです:
- JIT プロビジョニングを一時的にオフにします。
- Klaviyo でユーザーの役割を更新します。
- JIT を再度オンにします。
免除リストを表示できません
除外リストを表示するには、SSO を設定しておく必要があります。手順については、Klaviyo で SSO を有効にする方法に関する記事をご覧ください。
その他のリソース
- シングルサインオン(SSO)の設定方法
Klaviyo アカウントまたはポートフォリオ向けにシングルサインオン(SSO)を設定する方法をご確認ください。現在、Klaviyo では ID プロバイダー(IdP)シングルサインオンのみがサポートされています。
- 多要素認証(MFA)の設定方法
Klaviyo アカウントやポートフォリオの安全性を強化できる MFA の設定方法について、学びましょう。MFA を有効にすると、ユーザー名とパスワードを使ってログインし、コード入力などによって本人確認を行います。
- SCIM ユーザー プロビジョニングを設定する方法
アカウントまたはポートフォリオで、クロスドメイン ID 管理(SCIM)ユーザープロビジョニングのシステムを設定する方法をご確認ください。