組織セキュリティ管理者は以下の手順に従って、 SAML シングルサインオン設定を組織に設定することができます。SAML ベースのシングルサインオン(SSO)により、メンバーは ID プロバイダー(IdP)を通じて Workiva にアクセスできる。設定を構成する前に、 SAML シングル・サインオンとはを確認してください。
注:組織セキュリティ管理者は、組織管理者にアクセスするためにワークスペースに追加する必要があります。
ステップ 1: SAML SSO 設定に移動します
- 組織管理へ移動します。
- 左側のメニューでID およびアクセス管理をクリックする。
- Authenticationタブにいることを確認する。
-
SSO 構成ページをクリックする。
既存の SSO(シングルサインオン)設定がある場合ページは次のようになる。
ステップ2:SAML SSO 設定を作成して ID プロバイダーを選択する
-
SSO 構成を作成をクリックする。
- Configuration nameを入力してドロップダウンからIdentity provider (IdP)を選択する。
- 続行するには構成を作成をクリックする。
ステップ3:Workiva メタデータを ID プロバイダー管理者に送信する
- Workivaメタデータセクションの下に識別子(エンティティ ID)と返信 URLが表示される。
-
詳細オプションをクリックしてサインオン URLとログアウト URLを表示する。
これらのURLは、各組織に固有であり変更することはできず、次のいずれかのリージョンマーカーが含まれる。 app.wdesk.com、apac.wdesk.com、ca.wdesk.com、eu.wdesk.com。 - これらの Workiva メタデータ URL を ID プロバイダー管理者に送信する。
またはWorkiva メタデータ XML をダウンロードをクリックして Workiva メタデータ XML ファイルをダウンロードし ID プロバイダー管理者に送信することもできる。 -
クロックスキュー許容値を調整できる。クロックスキュー許容値とは SAML IDプロバイダーと Workivaの間で許容される最大時間差のことである。デフォルトは 300 秒 (5 分) である。
ヒント: 値を大きくすると時間差の「許容ウィンドウ」が広がる。これにより拒否されるリクエストが減少し信頼性が向上する一方でセキュリティおよびパフォーマンスのリスクも生じる。逆に値を小さくするとタイムアウトによる認証失敗の可能性が高くなる。
- Microsoft AzureをIDプロバイダーとして使用している場合、IDプロバイダー管理者は、ID ロバイダーでSAML SSOを構成するのAzureタブのステップ2を参照できる。
- OktaをIDプロバイダーとして使用している場合、IDプロバイダー管理者は、IDプロバイダーでSAML SSOを構成するのOktaタブのステップ3を参照できる。
- Microsoft AzureやOkta以外のIDプロバイダーを使用している場合、サポートが必要なときは、IDプロバイダーのカスタマーサポートに連絡する。
ステップ 4 Workiva に ID プロバイダーのメタデータを入力する
前提条件 続行する前に ID プロバイダー管理者から必要な ID プロバイダーのメタデータ情報を取得する必要がある。
- Microsoft AzureをIDプロバイダーとして使用している場合、IDプロバイダー管理者は、IDプロバイダーでSAML SSO を構成するのAzureタブのステップ4を参照できる。
- OktaをIDプロバイダーとして使用している場合、IDプロバイダー管理者は、IDプロバイダーでSAML SSOを構成するのOktaタブのステップ2を参照できる。
- Microsoft Azure や Okta 以外の ID プロバイダーを使用している場合は ID プロバイダーのカスタマーサポートに連絡して情報を取得する。
ID プロバイダーのメタデータセクション (例 Microsoft Azure metadata) で ID プロバイダーのメタデータを入力する。
- まずご希望の仕分け方法ドロップダウンで ID プロバイダーのメタデータを入力する方法を選択する。フェデレーションメタデータ URLを入力するかメタデータ XMLファイルをアップロードするか手動入力でメタデータを入力できる。
-
ファイル選択ダイアログで ID プロバイダーのメタデータ情報が含まれるファイルを選択してインポートをクリックする。
または手動で値を入力できる。
ステップ5:ユーザーマッピングを設定する
ユーザーマッピングセクションでドロップダウンをクリックしていずれかを選択する。
- ユーザーを Workiva ユーザー名にマップ(推奨)
- ユーザーをマニュアルでマップ
注:IDプロバイダーのメタデータ情報を手動で入力した場合はこのセクションの詳細オプションをオンに切り替える必要がある。
ユーザーを Workiva ユーザー名にマッピングする
ドロップダウンでユーザーを Workiva ユーザー名にマップを選択した場合、Workiva はユーザーがログインしたときに受信するPrimary NameID属性が、大文字小文字の区別を無視して Workivaユーザー名と一致することを期待する。例えば、User.Name.Example と、user.name.example をマッチさせることができます。
次にマッピングを設定ドロップダウンをクリックしてすべての SSO ID を Workiva ユーザー名に設定を選択しテーブルに値を入力できる。
続行するには構成を作成をクリックする。
ユーザーを手動でマッピングする
ドロップダウンでユーザーをマニュアルでマップを選択した場合はまず詳細オプションを確認する。NameIdentifier locationではほとんどの設定でNameIdentifier is in Subject statementオプションが選択されている。これは Workiva が Subject ステートメント内で NameIdentifier 要素をチェックすることを意味する。
ただしNameIdentifier は別の要素属性にありますオプションを選択して、NameIdentifier 要素属性を入力することでアプリケーションがSAML応答内で属性を検索するようにできる。
注: ほとんどの組織のセキュリティ管理者は、NameIdentifierの場所をデフォルトから変更しない。変更を加える前に、Workivaサポートに連絡してサポートを受ける。
ファイルインポートによるユーザーのマッピング
マッピングを設定をクリックしてSSO ID をファイル経由でインポートを選択しユーザーを .csv マッピングファイルの SSO ID にマッピングする (SAML ID .csv マッピングファイルの要件を参照)。
- マッピングファイルにヘッダーは必要ない。
- すべての行が処理され無効な行はスキップされる。
- 重複するユーザー名がある場合はそのユーザー名を持つ最初の行のみが使用される。
- 提供されたユーザー名に既存のマッピングがある場合、のマッピングはマッピングファイルで提供されたものに更新される。
- 行がスキップされた場合失敗はSAML シングルサインオンアクティビティログに記録される。
ユーザーを個別にマッピングする
ユーザーのSSO IDを個別に設定または編集する必要がある場合は、ユーザーを検索するか、SSO IDステータスフィルターを使用してユーザーをより簡単に見つける。次にテーブルでユーザーの横にあるSSO IDフィールドをダブルクリックして正しいSSO IDを入力する。
ユーザーマッピングを設定した後構成を作成をクリックして続行する。
SAML ID .csv マッピング・ファイルの要件
SAML ID .csv マッピング・ファイルの有効な行は、以下の形式に従います:
samlId,ユーザー名 以下の場合、行は無効です:
- 2つ未満の項目が並んでいます。
- SAML ID および/またはユーザ名が提供されていません。
- 指定されたユーザー名が存在しません。
- 指定されたユーザー名のユーザーは組織のメンバーではありません。
- 指定されたユーザー名のユーザーの主組織が、現在変更されている組織と同じではありません。
- 指定された SAML ID は、別のユーザによって既に使用されています。
有効なマッピングファイルの例は次のようになります:
exampleSamlId,exampleUsername exampleSamlId2,exampleUsername2 exampleSamlId3,exampleUsername3
ステップ6:SAML SSO 設定を有効にする
SAML SSO 設定を作成した後設定を有効にするには明示的にアクティベートする必要がある。
設定でアクティブ化をクリックする。設定はアクティブとして表示される。
ステップ7:SAML SSO 認証オプションを更新する
Workiva は、ログインプロセスを簡素化して全体的なエクスペリエンスを向上させるベストプラクティスとしてユーザーに SSO(シングルサインオン)を使用してサインインすることを強制することを強く推奨する。SAML SSO設定を作成して、有効化した後次の手順を実行する。
-
シングルサインオンタブのSSO を強制し例外を設定セクションには 2 つの認証オプションが表示される。
-
SSO を使用してサインインするようユーザーに強制(推奨):非管理者ユーザーは SSO(シングルサインオン)を使用することが強制されるが組織のセキュリティ管理者は引き続きユーザー名とパスワードを使用してサインインできる。このオプションは、会社としてSSO(シングルサインオン)を強制しつつ、SSOに問題が発生した場合でも組織のセキュリティ管理者がプラットフォームにアクセスできるようにしたい場合に、最も適している。
注: このオプションを有効にする前に、包括的なテストを実施して、SAML SSOの設定に完全に自信があることを確認する。
- 組織のセキュリティ管理者に SSO を使用してサインインすることを強制:組織のセキュリティ管理者は SSO(シングルサインオン)を使用することが強制される。このオプションは、会社のセキュリティポリシーによりユーザーを SSO(シングルサインオン)要件から除外したくない場合に最適である。このオプションを有効にするにはSSO を使用してサインインするようユーザーに強制もオンにする必要がある。これは認証タブのSSO要件ページにある。
-
- オプションを選択した後、保存をクリックする。
必要に応じて特定のユーザーをSSO例外リストに追加することで、SAML SSOを使用せずにサインインできるようにすることができる。
注: SAML SSO を強制する前に、ユーザーがアカウントからロックアウトされないように必要なユーザーを SSO 例外リストに追加する。
IDプロバイダーでSAML SSOを構成する
ID プロバイダー管理者は一般的な ID プロバイダーで SAML SSO を構成する方法について以下の手順を参照できる。
対応機能
- SP 主導の SSO(シングルサインオン)
- IdP 主導の SSO(シングルサインオン)
- IdP 主導の SLO (シングルログアウト)
- SSO(シングルサインオン)例外リスト
- オプションのアサーション暗号化
ステップ1:統合を追加する
- Okta管理ポータルにサインインしてアプリケーションの下でアプリカタログを閲覧を選択する。
- アプリ統合カタログで、 Workiva を検索し、選択します。次に統合を追加をクリックする。
- ITポリシーと手順に従って、一般的な設定を行います。次に次へをクリックします。
ステップ 2 Okta のメタデータを Workiva に入力する
SAML 2.0 セクションでは、デフォルトのリレーステートを空白のままにします。Workiva: 「IDプロバイダーのメタデータをWorkivaに入力する」のステップ4に記載されている手順に従い、WorkivaにアップロードするためのメタデータXMLファイルをダウンロードしてください。
XML ファイルをダウンロードする 1 つの方法はメタデータ URL をコピーしてブラウザに貼り付けページを XML ファイルとして保存することである。
ステップ3:Workiva メタデータを Okta に入力する
Workiva のステップ 3 Workiva メタデータを ID プロバイダー管理者に送信するにある Workiva URL を使用して次の操作を行う。
- Workiva のACS URLをコピーして Okta のACS URLフィールドに貼り付ける。
- Workiva のAudience URLをコピーして Okta のAudience URLフィールドに貼り付ける。
ステップ4:属性と要求を編集する
Oktaの属性とクレームでは、Workivaのユーザー名(大文字と小文字を区別しない)をプライマリNameID属性に一致させ、ユーザーが初めてSSOでサインインしたときに、Workivaが自動的にその属性をWorkivaのユーザー名にマッピングするようにすることを推奨します。ただしこのマッピングは特定の IT ポリシーによって異なる。
これらの属性が一致しない場合はユーザーが SSO(シングルサインオン)でサインインできるようになる前にWorkiva のステップ5「ユーザーマッピングを設定する」で説明されているように属性を対応するユーザー名に手動でマッピングする必要がある。
SP 主導の SSO(シングルサインオン)プロセス
サインインプロセスはホーム組織の SP URL (app.wdesk.com または apac.wdesk.com または ca.wdesk.com または eu.wdesk.com) から開始される。
- ブラウザから Workiva サインインページに移動する。
- Workivaユーザー名を入力する。
- シングルサインオンでサインインをクリックする。
- 組織のサインインページにリダイレクトされる。
- 資格情報を入力して、組織のポリシーに従って追加のチャレンジを通過する。
- Workiva にリダイレクトされてインターフェースにログインする。
ステップ1:アプリケーションを作成する
- Azure管理ポータルにサインインしてMicrosoft Entra ID / エンタープライズアプリケーションに移動する。
- 新規アプリケーションをクリックします。
-
Workiva を検索し、選択します。
SCIMの実装を計画している場合はカスタムアプリケーションを作成する必要があることに注意する。 - アプリケーションに名前を付け、作成をクリックします。
- アプリケーションが作成されたらシングルサインオン>SAMLに移動する。
ステップ2:Workiva メタデータを Microsoft Azure に入力する
- ベーシックなSAML構成を編集する。
-
Workiva のステップ 3 「Workiva メタデータを ID プロバイダー管理者に送信する」にある Workiva URL を使用して次の操作を行う。
- Workiva のIdentifier (Entity ID)をコピーして Azure のIdentifier (Entity ID)フィールドに貼り付ける。
- Workiva のReply URLをコピーして Azure のReply URL (Assertion Consumer Service URL)フィールドに貼り付ける。
- (オプション) Workiva のSign on URLをコピーして Azure のSign-on URLフィールドに貼り付ける。
- リレーステートフィールドは空白のままにしておきます。
- (オプション) Workiva のLogout URLをコピーして Azure のLogout URLフィールドに貼り付ける。
ステップ3:属性と要求を編集する
設定が保存されたら属性とクレームを編集する。ユーザーが初めて SSO(シングルサインオン)でサインインしたときに Workiva が属性を Workiva ユーザー名に自動的にマッピングできるように Workiva ユーザー名 (大文字小文字は区別されない) を Primary NameID 属性と一致させることが推奨される。ただしこのマッピングは特定の IT ポリシーによって異なる。
- これらの属性が一致しない場合はユーザーが SSO(シングルサインオン)でサインインできるようになる前にWorkivaのステップ5「ユーザーマッピングを設定する」で説明されているように属性を対応するユーザー名に手動でマッピングする必要がある。
- Workiva は、必須クレーム固有のユーザー識別子 (NameID) のユーザーのみを調べ、それ以外のクレームは無視されます。
ステップ 4 Microsoft Azure メタデータを Workiva に入力する
フェデレーションメタデータ URLを介してMicrosoft Azure メタデータを Workivaに入力する場合は、Azure SAML SSO設定内でフェデレーションメタデータURLを見つけることができる。
メタデータ XML ファイルを介して Microsoft Azure メタデータを Workiva に入力する場合はSAML CertificatesセクションでFederation Metadata XMLの横にあるDownloadをクリックする。次にメタデータ XML ファイルを Workiva にアップロードする。
注: Microsoft Azure を ID プロバイダーとして使用している場合は、WorkivaのログインURLフィールド (詳細オプションの下) を空白のままにしないとサインインエラーが発生することを確認する。
Logout URL (Advanced options の下) が必要なのにアップロードした XML メタデータファイルにその値が見つからない場合はその値を手動で貼り付ける必要がある。