SSO認証機能
SSO 認証機能について
この 認証機能 Qualtricsの機能は通常、回答者が以下にあることを確認するために使用されます。 連絡先リスト クアルトリクスにアップロードした情報ですシングルサインオン (SSO) 認証機能を使用することで、これを超えてサードパーティシステムに対して認証を行うことができます (たとえば、大学に正規のユーザ ID があるか、Facebook アカウントを持っているかを確認します)。
認証機能では、以下の 6 つの基本タイプの SSO 認証がサポートされています。
- トークン: サードパーティは、回答者が自動的にログインできる安全なトークンを生成します(検証されている場合)。
- CAS (セントラル認証サービス): 回答者が CAS サーバーに対して認証を行います。
- LDAP (Lightweight Directory Access Protocol): LDAP は、ユーザの認証に使用されます。
- シボレス: 回答者はSAMLを使用して認証します。
- Google OAuth 2.0: 回答者はGoogleユーザー名で認証を行います。
- Facebook: 回答者はFacebookのユーザー名で認証を行います。
以下は、各方法の設定方法についての簡単な説明であり、連絡先リストの使用方法に関する基本的な知識を得ています。 認証機能. SSO の詳細については、シングルサインオンの技術文書を参照してください。
トークン
トークン認証では、サードパーティを介して生成されたセキュアトークンを使用して認証することができます。トークン認証機能は、暗号化された埋め込みデータをアンケートに渡すために使用することもでき、暗号化された埋め込みデータは復号化され、次のように保存される。 埋め込みデータ.
トークン認証機能を設定する
- アンケートの編集中に、[アンケートフロー]を開きます。
- [こちらに新しい要素を追加]または[下に追加]をクリックします。
- Authenticator を選択します。
- 認証タイプをSSO に変更します。
- SSO タイプをトークンに変更します。
- 暗号化方式、Mac 方式、および余裕を指定します (余裕として 300 を指定することをお奨めします)。セキュアキーを生成したり、独自のキーに入力したりすることもできます。
- [適用]をクリックします。
識別情報を取得するには、次の手順に従います (オプション)。
- 回答者の識別情報を記録できるようにする。
- [ 埋め込みデータを追加 ]をクリックします。
- 埋め込みデータフィールド名を、等号の左側にある[設定する埋め込みデータ]自由回答欄ボックスに入力します。
- 暗号化されたトークンのパラメータ名を [Field From SSO] テキストボックスに挿入します。
- 必要に応じて、プラス記号 (+) をクリックしてフィールドを追加し、マイナス記号 (-) をクリックしてフィールドを削除します。
- [適用]をクリックします。
他のユーザがアンケートに回答すると、埋め込みデータ値が回答結果に表示されます。
担当者一覧と関連回答 (オプション)
デフォルトでは、トークン SSO 認証機能により、参加者はアンケートに複数回回答することができます。この動作を回避し、参加者がアンケートに1回のみ回答できるようにするには、[パネルに回答者を関連付け]を有効にします。このオプションを使用すると、参加者はアンケートに回答するために選択した連絡先リストのメンバーになります。
以下のテーブルは、連絡先リスト([フィールドで識別]ドロップダウンで指定)のどの識別フィールドがどのトークン認証属性とペアになるかを示しています。
項目による識別 | トークン属性 |
名 | firstname firstname |
姓 | lastname |
メール | メール |
External Data Reference | id |
たとえば、[識別フィールド]が[姓]で、回答者が[姓]属性に「Doe」を渡していた場合、連絡先リストの[姓]フィールドに「Doe」が含まれている必要があります。
CAS
CAS 認証では、CAS サーバに対してユーザを認証できます。また、参加者の CAS ユーザー名を以下として取得および保存するために使用することもできます。 埋め込みデータ.
CAS 認証機能を設定する
- アンケートの編集中に、[アンケートフロー]を開きます。
- [こちらに新しい要素を追加]または[下に追加]をクリックします。
- オーセンティケータ
の選択 - 認証タイプをSSO に変更します。
- SSO タイプをCAS に変更します。
- ホスト名、ポート、および URI を指定します。
- [適用]をクリックします。
識別情報を取得するには、次の手順に従います (オプション)。
- 回答者の識別情報を記録できるようにする。
- [ 埋め込みデータを追加 ]をクリックします。
- 埋め込みデータフィールド名を、等号の左側にある[設定する埋め込みデータ]自由回答欄ボックスに入力します。
- [SSOのフィールド]テキストボックスに username パラメータを挿入します。
- 必要に応じて、プラス記号 (+) をクリックしてフィールドを追加し、マイナス記号 (-) をクリックしてフィールドを削除します。クアルトリクスではCASのユーザー名属性のみが受け入れられるため、属性を取得するために指定されたフィールドはすべてユーザー名を返します。
- [適用]をクリックします。
ユーザーがアンケートに回答すると、埋め込みデータ値が回答結果に表示されます。
担当者一覧と関連回答 (オプション)
デフォルトでは、CAS SSO 認証機能により、参加者はアンケートに複数回回答できます。この動作を回避し、参加者がアンケートに1回のみ回答できるようにするには、[パネルに回答者を関連付け]を有効にします。このオプションを使用すると、参加者はアンケートに回答するために選択した連絡先リストのメンバーになります。
CAS オーセンティケータではユーザー名のみを使用できるため、ユーザーを適切に認証するために、([識別フィールド]ドロップダウンを使用して)識別フィールドとして選択された連絡先リストフィールドに CAS ユーザー名が含まれている必要があります。
たとえば、識別フィールドが名で、回答者がCASのユーザー名に「johnd」を渡していた場合、連絡先リストの[名]フィールドに「johnd」が含まれる必要があります。
LDAP
LDAP 認証では、LDAP サーバに対して直接ユーザを認証できます。また、LDAP 属性を埋め込みデータとして取得して保存するために使用することもできます。
LDAP 認証を設定するには、次の手順に従います。
- アンケートの編集中に、[アンケートフロー]を開きます。
- [こちらに新しい要素を追加]または[下に追加]をクリックします。
- Authenticator を選択します。
- 認証タイプをSSO に変更します。
- SSO タイプをLDAP に変更します。
- ホスト名、ポート、ベース DN、バインド DN、バインドパスワード、およびフィルタを指定します。
ヒント:フィルターフィールドは([filter]=%1)の形式で残す必要があります((sAMAccountName=%1)または(uid=%1)など)。
- [適用]をクリックします。
識別情報を取得するには、次の手順に従います (オプション)。
- 回答者の識別情報を記録できるようにする。
- [ 埋め込みデータを追加 ]をクリックします。
- プラス記号 (+) を使用して、4 つの項目を追加します。
- 埋め込みデータフィールド名を、等号の左側にある[設定する埋め込みデータ]自由回答欄ボックスに入力します。
- [SSOのフィールド]テキストボックスに[FirstName]、[LastName]、[Email]、[ExternalDataReference]の各パラメータを挿入します。
- 各項目に属性名を挿入します。
- [適用]をクリックします。
ユーザーがアンケートに回答すると、埋め込みデータ値が回答結果に表示されます。
連絡先リストと回答を関連付ける
デフォルトでは、LDAP SSO認証機能により参加者はアンケートに複数回回答できます。この動作を回避し、参加者がアンケートに1回のみ回答できるようにするには、[パネルに回答者を関連付け]を有効にします。このオプションを使用すると、参加者はアンケートに回答するために選択した連絡先リストのメンバーになります。
以下のテーブルは、コンタクト一覧ペアからの識別項目 (項目により識別ドロップダウンで決定) と、認証機能設定の名項目、姓項目、電子メール項目、および外部データ参照で指定された LDAP 認証属性を示しています。
項目による識別 | LDAP 属性 |
名 | 名項目 (例: firstname) |
姓 | 姓フィールド (例: lastname) |
メール | 電子メールフィールド (メールなど) |
External Data Reference | 外部データ参照 (uid) |
たとえば、識別フィールドが電子メールであり、LDAP 認証設定で以下の属性が指定されているとします。
回答者がメール属性の「johnd@email.com」を渡していた場合、連絡先リストの[メール]フィールドに「johnd@email.com」が含まれている必要があります。
シボレス
シボレスでは、SAML による認証が可能です。SAML は 2 方向の接続であるため、このオプションはシボレスをブランドにすでに設定しているユーザのみが使用できます。シボレスSSOが設定されているかどうかについては、 ブランド管理者.
シボレス認証装置を設置し
- アンケートの編集中に、[アンケートフロー]を開きます。
- [こちらに新しい要素を追加]または[下に追加]をクリックします。
- Authenticator を選択します。
- 認証タイプをSSO に変更します。
- SSOタイプをシボレスに変更。
- 使用する接続を選択します。デフォルトとして表示されるオプションをお奨めします。
ヒント: ブランド管理者は、組織全体で利用可能なSSO接続を管理できます。関連する詳細と警告については、「アンケート認証のためのSSO接続の管理」を参照してください。
- [適用]をクリックします。
識別情報を取得するには、次の手順に従います (オプション)。
- 回答者の識別情報を記録できるようにする。
- [ 埋め込みデータを追加 ]をクリックします。
- プラス記号 (+) を使用して項目を追加し、マイナス符号 (-) を使用して項目を削除します。
- 埋め込みデータフィールド名を、等号の左側にある[設定する埋め込みデータ]自由回答欄ボックスに入力します。
- SAML を介して渡される属性の正式名称またはフレンドリ名を “Field From SSO” テキスト入力ボックスに挿入します (プラス記号をクリックして項目を追加することができます)。
- [適用]をクリックします。
ユーザーがアンケートに回答すると、埋め込みデータ値が回答結果に表示されます。
連絡先リストと回答を関連付ける
デフォルトでは、シボレスSSO認証機能により参加者はアンケートに複数回回答できます。この動作を回避し、参加者がアンケートに1回のみ回答できるようにするには、[パネルに回答者を関連付け]を有効にします。このオプションを使用すると、参加者はアンケートに回答するために選択した連絡先リストのメンバーになります。
下の表は、クアルトリクスインスタンスのSSO設定の[ユーザー名]フィールド、[名]フィールド、[姓]フィールド、メールフィールドで指定された、連絡先リストのペアからの識別フィールドとどの SAML 属性([フィールドで指定]ドロップダウンで指定)を示したものです。
項目による識別 | SAML 属性 |
External Data Reference | ユーザ名 (uid など) |
名 | 名項目 (givenName など) |
姓 | 姓フィールド (例: sn) |
メール | 電子メールフィールド (メールなど) |
たとえば、識別機能が外部データ参照で、回答者がud属性に「johnd」を渡していた場合、連絡先リストの[外部データ参照]フィールドに「johnd」が含まれる必要があります。
Google OAuth 2.0
Google OAuth 2.0 認証では、回答者が Google 認証情報を使用して認証できます。また、Googleアカウント情報を埋め込みデータとして取り込んで保存することも可能。
Google OAuth 2.0 Authenticator を設定する
- アンケートの編集中に、[アンケートフロー]を開きます。
- [こちらに新しい要素を追加]または[下に追加]をクリックします。
- Authenticator を選択します。
- 認証タイプをSSO に変更します。
- SSO タイプをGoogle OAuth 2.0 に変更します。
ヒント:デフォルトでは、Google OAuth 2.0認証機能によりGoogleアカウントを持つすべてのユーザーが認証されます。アンケートにアクセスできるユーザーを制限するには、[ドメインに認証を制限]フィールドに承認済みのアカウントのメールドメインを追加します。ここではワイルドカードは必要ありません。@ 記号なしでドメインを入力する必要があります (例: “gmail.com” または “qualtrics.com”)。複数のドメインを許可するには、ドメインをカンマ区切り一覧として入力します (例: “gmail.com, qualtrics.com”)。ブランド管理者は、組織のSSO設定を行って、オーセンティケータにアクセスできるユーザーを制限することもできます。
- [適用]をクリックします。
識別情報を取得するには、次の手順に従います (オプション)。
- 回答者の識別情報を記録し、[埋め込みデータを追加]をクリックします。
- プラス記号 (+) を使用して項目を追加し、マイナス符号 (-) を使用して項目を削除します。
- 埋め込みデータフィールド名を、等号の左側にある[設定する埋め込みデータ]自由回答欄ボックスに入力します。
- Google OAuth 2.0 のパラメータフィールドを [Field From SSO] テキスト入力ボックスに挿入します。以下の一覧から項目を選択することができます。
- 属性
- 値
- FirstName
- 山田
- LastName
- 太郎
- メール
- johndoe@email.com
- [適用]をクリックします。
ユーザーがアンケートに回答すると、埋め込みデータ値が回答結果に表示されます。
連絡先リストと回答を関連付ける
デフォルトでは、Google OAuth 2.0認証機能により参加者はアンケートに複数回回答できます。この動作を回避し、参加者がアンケートに1回のみ回答できるようにするには、[パネルに回答者を関連付け]を有効にします。このオプションを使用すると、参加者はアンケートに回答するために選択した連絡先リストのメンバーになります。
以下の表は、コンタクト一覧のペアからどの識別項目 (項目により識別ドロップダウンで指定) とどの Google OAuth 2.0 属性があるかを示しています。
項目による識別 | Google OAuth 属性 |
名 | FirstName |
姓 | LastName |
メール | メール |
External Data Reference | ユーザ名 |
たとえば、識別フィールドが[名]で、回答者が[名]属性に「John」を渡していた場合、連絡先リストの[名]フィールドに「John」と入力する必要があります。
Facebook 認証では、回答者が Facebook 認証情報を使用して認証できます。また、Facebookのアカウント情報を埋め込みデータとして取得・保存することも可能。
Facebook Authenticator を設定する
- アンケートの編集中に、[アンケートフロー]を開きます。
- [こちらに新しい要素を追加]または[下に追加]をクリックします。
- Authenticator を選択します。
- 認証タイプを SSO に変更します。
- SSO タイプを Facebook に設定します。
- [適用]をクリックします。
識別情報を取得するには、次の手順に従います (オプション)。
- 回答者の識別情報を記録できるようにする。
- [ 埋め込みデータを追加 ]をクリックします。
- プラス記号 (+) を使用して項目を追加し、マイナス符号 (-) を使用して項目を削除します。
- 等号の左側にある[セットする埋め込みデータ…]テキストボックスに埋め込みデータフィールド名を入力します。
- Facebook のパラメータフィールドを [Field From SSO] テキスト入力ボックスに挿入します。以下の一覧から項目を選択することができます。
- 属性
- 値
- 名前
- 山田太郎
- first_name
- 山田
- last_name
- 太郎
- リンク
- http://www.facebook.com/johndoe
- gender
- 男性
- メール
- johndoe@email.com
- 適用をクリックします。
ユーザーがアンケートに回答すると、埋め込みデータ値が回答結果に表示されます。
連絡先リストと回答を関連付ける
デフォルトでは、Facebook認証機能により参加者はアンケートに複数回回答できます。この動作を回避し、参加者がアンケートに1回のみ回答できるようにするには、[パネルに回答者を関連付け]を有効にします。このオプションを使用すると、参加者はアンケートに回答するために選択した連絡先リストのメンバーになります。
以下のテーブルは、コンタクト一覧のペアからどの識別項目 (項目により識別ドロップダウンで指定) とどの Facebook パラメータがあるかを示しています。
項目による識別 | Facebook 属性 |
名 | first_name |
姓 | last_name |
メール | メール |
External Data Reference | メール |
たとえば、識別フィールドがメールで、回答者がメール属性の「johnd@email.com」を渡していた場合、連絡先リストの[メール]フィールドに「johnd@email.com」が含まれている必要があります。
認証の最大試行回数
オプションに、最大認証試行回数という設定が表示されます。 SSO認証機能を使用する場合、回答者はQualtricsアンケートではなくSSOランディングページに移動してログインします。クアルトリクスアンケートは、そのSSOページのログイン失敗を認識していません。つまり、SSO 認証機能の認証試行回数の上限設定は効果がないため、通常は推奨されません。
SSO認証機能を使用したアンケートで認証を試行できる最大時間は、[パネルを持つ回答者を関連付け]が有効になっている場合です。この場合、ユーザーは連結リストの連絡先と一致しなかったため、エラーが発生します。
認証機能へのログイン時のエラー
アンケート回答者がSSO認証機能にログインしようとすると、次のエラーが表示される場合があります。これらが何を意味し、どのように解決するかを説明します。
- AUTHENTICATOR_SSO_CONFIG_DISABLED: ブランド管理者は、 SSO接続用のアンケート認証機能で使用を有効にする.
- AUTHENTICATOR_SSO_CONFIG_NOT_FOUND: SSO プロバイダサービスで SSO 接続が見つかりませんでした。これは、データ同期の問題が原因であるか、接続が削除されたために発生する可能性があります。ブランド管理者は次のことを行う必要もあります SSO接続用のアンケート認証機能で使用を有効にする.
この機能を使用できるプロジェクトの種類
アンケートフローは、さまざまな種類のプロジェクトでカスタマイズできます。ただし、すべての種類のプロジェクトで一部のアンケートフロー機能を使用できません。
認証機能は、以下のプロジェクトで使用できます。