Citrix FilesでのSAMLによるシングルサインオン

Endpoint ManagementとCitrix Filesを構成して、SAML(Security Assertion Markup Language:セキュリティアサーションマークアップランゲージ)を使用したCitrix Filesモバイルアプリへのシングルサインオン(SSO:Single Sign-On)アクセスを提供することができます。MDX ServiceまたはMDX Toolkitを使用してラップされたCitrix Filesアプリと、Webサイト、Outlookプラグイン、SyncクライアントなどのラップされてないCitrix Filesクライアントがこの機能の対象となります。

  • ラップされたCitrix Filesアプリの場合 。Citrix Filesモバイルアプリを介してCitrix Filesにログオンするユーザーは、ユーザー認証のためにSecure Hubにリダイレクトされ、SAMLトークンを取得します。認証が成功した後で、Citrix FilesモバイルアプリからCitrix FilesにSAMLトークンが送信されます。最初のログオンの後、ユーザーはSSOを介してCitrix Filesモバイルアプリにアクセスできます。また、毎回ログオンしなくても、Secure MailのメールにCitrix Filesからドキュメントを添付できます。
  • ラップされていないCitrix Filesクライアントの場合。WebブラウザーまたはほかのCitrix Filesクライアントを介してCitrix Filesにログオンするユーザーは、Endpoint Managementにリダイレクトされます。Endpoint Managementで認証されると、ユーザーはCitrix Filesに送信されたSAMLトークンを取得します。最初のログオンの後は、毎回ログオンしなくてもユーザーはSSOを介してCitrix Filesクライアントにアクセスできます。

Endpoint ManagementをCitrix FilesのSAML IDプロバイダー(IdP)として使用するには、この記事で説明するように、Endpoint ManagementをCitrix Files Enterpriseを使用するように構成する必要があります。または、StorageZoneコネクタでのみ動作するようにEndpoint Managementを構成することもできます。詳しくは、「Citrix FilesとEndpoint Managementを使用する」を参照してください。

詳細なリファレンスアーキテクチャ図については、「アーキテクチャ」を参照してください。

前提条件

Endpoint ManagementおよびCitrix FilesアプリにSSOを構成する前に、以下の前提条件を満たしている必要があります:

  • MDX Serviceまたは互換性があるバージョンのMDX Toolkit(Citrix Filesモバイルアプリ用)。

    詳しくは、「Endpoint Managementの互換性」を参照してください。

  • 互換性があるバージョンのCitrix FilesモバイルアプリとSecure Hub
  • Citrix Files管理者アカウント
  • Endpoint ManagementとCitrix Files間の確認された接続

Citrix Filesへのアクセスの構成

Citrix FilesのためにSAMLを設定する前に、以下のようにCitrix Filesアクセス情報を入力します。

  1. Endpoint Management Webコンソールで、[Configure]の[ShareFile]をクリックします。[ShareFile] 構成ページが開きます。

    ShareFile構成画面の画像

  2. 次の設定を構成します。

    • ドメイン: Citrix Filesサブドメイン名を入力します。例:example.sharefile.com
    • デリバリーグループに割り当て: ShareFileと共にSSOを使用するデリバリーグループを選択または検索します。
    • ShareFile 管理者アカウント ログオン
    • ユーザー名: Citrix Files管理者のユーザー名を入力します。このユーザーには管理特権が必要です。
    • パスワード: Citrix Files管理者のパスワードを入力します。
    • ユーザーアカウントのプロビジョニング: Endpoint Managementでユーザープロビジョニングを有効にするには、この設定を有効にします。ユーザープロビジョニングにCitrix Filesユーザー管理ツールを使用するには、この設定を無効のままにします。

    注:

    選択した役割にCitrix Filesアカウントを持たないユーザーが含まれ、[ユーザーアカウントのプロビジョニング]が有効な場合:そのユーザーに自動的にCitrix Filesアカウントがプロビジョニングされます。構成をテストするために、メンバーが少ない役割を使用することをお勧めします。これにより、多くのユーザーがCitrix Filesアカウントを持たない可能性を避けることができます。

  3. [接続のテスト] をクリックして、Citrix Files管理者アカウントのユーザー名とパスワードが特定のCitrix Filesアカウントに対して認証されることを検証します。

  4. [Save] をクリックします。Endpoint ManagementがCitrix Filesと同期して、Citrix Filesの [ShareFile発行者/エンティティID][ログインURL] の設定が更新されます。

ラップされたCitrix Files MDXアプリ用のSAMLの設定

以下の手順がiOSおよびAndroidのアプリおよびデバイスに当てはまります。

  1. Citrix Files MobileアプリをMDXでラップします。詳しくは、「Endpoint Management MDX Service」を参照してください。

  2. Endpoint Managementコンソールで、ラップされたCitrix Filesモバイルアプリをアップロードします。MDXアプリをアップロードする方法について詳しくは、「MDXアプリをEndpoint Managementに追加するには」を参照してください。

  3. SAML設定の検証:上記の手順で構成した管理者のユーザー名とパスワードでCitrix Filesにログオンします。

  4. Citrix FilesおよびEndpoint Managementが同じタイムゾーンで構成されていることを確認します。構成したタイムゾーンに関して、Endpoint Managementに正しい時刻が表示されていることを確認します。そうでない場合、SSOが失敗する可能性があります。

Citrix Filesモバイルアプリの検証

  1. ユーザーデバイスにSecure Hubをインストールして構成します。

  2. アプリストアからCitrix Filesモバイルアプリをダウンロードしてインストールします。

  3. ユーザー名やパスワードの入力を求められずにCitrix Filesが開始されます。

Secure Mailによる検証

  1. まだ行っていない場合は、ユーザーデバイスにSecure Hubをインストールして構成します。

  2. アプリストアからSecure Mailをダウンロード、インストール、および設定します。

  3. 新規メールを開いて [ShareFileから添付] をタップします。メールに添付できるファイルがユーザー名とパスワードを入力しなくても表示されます。

ほかのCitrix FilesクライアントのためにCitrix Gatewayを構成する

Webサイト、Outlook Plug-in、SyncクライアントなどのラップされていないCitrix Filesクライアントへのアクセスを構成するには、以下のようにCitrix Gatewayを構成して、SAML IDプロバイダーとしてのEndpoint Managementの使用をサポートする必要があります。

  • ホームページのリダイレクトを無効にする。
  • Citrix Filesのセッションポリシーとプロファイルを作成する。
  • Citrix Gateway仮想サーバーにポリシーを構成する。

ホームページのリダイレクトを無効にする

/cginfraパスから送られる要求に対するデフォルトの動作を無効にします。この操作により、ユーザーは、構成されたホームページの代わりに本来要求された内部URLを見ることができるようになります。

  1. Endpoint Managementのログオンに使用されるCitrix Gateway仮想サーバーの設定を編集します。Citrix Gatewayで、[他の設定] に移動して [ホームページにリダイレクト] チェックボックスをオフにします。

     Citrix Gateway画面のイメージ

  2. [ShareFile] の下にEndpoint Managementの内部サーバー名およびポート番号を入力します。

  3. [AppController] の下にEndpoint ManagementのURLを入力します。

    この構成により、/cginfraパスを介して入力したURLに対する要求が承認されます。

Citrix Filesのセッションポリシーと要求プロファイルを作成する

以下の設定を構成してCitrix Filesセッションポリシーと要求プロファイルを作成します:

  1. Citrix Gateway構成ユーティリティの左側のナビゲーションペインで、[NetScaler Gateway]、[ポリシー]、[セッション] の順にクリックします。

  2. セッションポリシーを作成します。[ポリシー] タブで [追加] をクリックします。

  3. [名前] ボックスに「ShareFile_Policy」と入力します。

  4. [+] をクリックして操作を作成します。[Create NetScaler Gateway Session Profile] ページが開きます。

    Citrix Gatewayのセッションプロファイル画面の画像

    次の設定を構成します:

    • Name:ShareFile_Profile」と入力します。
    • [Client Experience] タブをクリックし、以下の設定を構成します:
      • Home Page:none」と入力します。
      • Session Time-out (mins):1」と入力します。
      • Single Sign-on to Web Applications: この設定をクリックします。
      • Credential Index:[PRIMARY] をクリックします。
    • [Published Applications] タブをクリックします。

    Citrix Gatewayのセッションプロファイル画面の画像

    次の設定を構成します:

    • ICA Proxy:[ON] を選択します。
    • Web Interface Address: Endpoint ManagementサーバーのURLを入力します。
    • Single Sign-on Domain: Active Directoryドメイン名を入力します。

      Citrix Gatewayセッションプロファイルを構成するとき、[Single Sign-on Domain] に入力するドメインサフィックスをLDAPに定義するEndpoint Managementドメインエイリアスと一致させる必要があります。

  5. [Create] をクリックしてセッションプロファイルを定義します。

  6. [Expression Editor] をクリックします。

    Citrix Gatewayのセッションプロファイル画面の画像

    次の設定を構成します。

    • Value:NSC_FSRD」と入力します。
    • Header Name:COOKIE」と入力します。
  7. [Create] をクリックしてから、[Close] をクリックします。

    Citrix Gatewayのセッションプロファイル画面の画像

Citrix Gateway仮想サーバーにポリシーを構成する

以下の設定をCitrix Gateway仮想サーバーに構成します。

  1. Citrix Gateway構成ユーティリティの左側のナビゲーションペインで、[NetScaler Gateway]の[Virtual Servers] をクリックします。

  2. [Details] ペインでCitrix Gateway仮想サーバーをクリックします。

  3. [Edit] をクリックします。

  4. [Configured policies]の[Session policies] をクリックし、[Add binding] をクリックします。

  5. [ShareFile_Policy] を選択します。

  6. このポリシーの優先順位が一覧表示されるほかのポリシーよりも高くなるように、選択したポリシーに対して自動生成される [Priority] の番号を最も小さい数に変更します。次に例を示します。

    VPN仮想サーバーのセッションポリシーバインディング画面の画像

  7. [Done] をクリックして、Citrix Gateway構成を保存します。

Citrix Files.comのSSO設定を変更する

MDXおよび非MDX Citrix Filesアプリの両方に対して以下の変更を行います。

重要:

Endpoint ManagementでCitrix Filesアプリを編集または再作成したりCitrix Filesの設定を変更したりするたびに、内部アプリ名に新しい番号が付加されます。このため、Citrix Files WebサイトでログインURLも更新して、更新されたアプリ名を反映する必要があります。

  1. Citrix Files管理者としてCitrix Filesアカウント(https://<subdomain>.sharefile.com)にログオンします。

  2. Citrix Files Webインターフェイスで [管理] をクリックし、[シングルサインオン設定の構成] を選択します。

  3. [ログインURL] を以下のように編集します:

    編集前の [ログインURL]の例は次のとおりです:https://xms.citrix.lab/samlsp/websso.do?action=authenticateUser&app=ShareFile_SAML_SP&reqtype=1

    サンプルのログインURLの画像

    • Endpoint ManagementサーバーのFQDNの前にCitrix Gateway仮想サーバーの外部FQDNおよび「/cginfra/https/」を挿入し、Endpoint ManagementのFQDNの後に「8443」を追加します。

      編集したURLの例は次のとおりです: https://nsgateway.acme.com/cginfra/https/xms.citrix.lab:8443/samlsp/websso.do?action=authenticateUser&app=ShareFile_SAML_SP&reqtype=1

    • パラメーター&app=ShareFile_SAML_SPを、Citrix Files内部アプリ名に変更します。内部名はデフォルトで「ShareFile_SAML」です。ただし、構成を変更するたびに、内部名に数字が付加されます(例:ShareFile_SAML_2ShareFile_SAML_3)。

      編集したURLの例は次のとおりです: https://nsgateway.acme.com/cginfra/https/xms.citrix.lab:8443/samlsp/websso.do?action=authenticateUser&app=ShareFile_SAML&reqtype=1

    • &nssso=true」をURLの最後に追加します。

      最終的なURLの例は次のとおりです:https://nsgateway.acme.com/cginfra/https/xms.citrix.lab:8443/samlsp/websso.do?action=authenticateUser&app=ShareFile_SAML&reqtype=1&nssso=true

  4. [オプション設定] の下の [Web認証の有効化] チェックボックスをオンにします。

    オプション設定画面の画像

構成を検証する

以下の操作を実行して構成を検証します。

  1. ブラウザーでhttps://<subdomain>sharefile.com/saml/loginにアクセスします。

    Citrix Gatewayのログオンフォームにリダイレクトされます。リダイレクトされない場合は前の構成設定を検証します。

  2. Citrix Gatewayおよび構成したEndpoint Management環境のユーザー名とパスワードを入力します。

    <subdomain>.sharefile.comのCitrix Filesフォルダーが表示されます。Citrix Filesフォルダーが表示されない場合は、正しいログオン資格情報を入力したかどうか確認します。