Lucid ヘルプセンター   ›   airfocus   ›   設定   ›   AirFocusでOkta SAMLとSCIMを有効にしてください

AirFocusでOkta SAMLとSCIMを有効にしてください

著者:  Morgan T
最終更新日:  

SAMLシングルサインオン(SSO)とSCIMの使い方を学び、AirFocusアクセスをIDプロバイダー(IdP)に付与することで、組織のユーザーアイデンティティ管理に活用してください。 この記事では、Oktaのセットアップ推奨事項を紹介します。

この機能は、 AirFocus エンタープライズプラン のサブスクリプションを持つすべての顧客に提供されています。

SAMLのSSOおよびSCIMの導入

airfocusをOktaと統合することで、ユーザー自身がOkta経由でSAMLシングルサインオンで認証できるようになります。 シングルサインオンは、airfocus チームのアカウント管理者が既存のアイデンティティプロバイダーソリューション(IdP)を通じて誰がairfocusにアクセスできるかを特定できるようにします。 チームメンバーは組織のIdPにログインしていれば、AirFocusにシームレスにアクセスできます。

さらに、SCIMインテグレーションにより、アカウント管理者はAirFocusにサインインせずにユーザーを作成し、Okta内でユーザーをプロビジョニング・解除できます。

注: 初めてairfocusにアクセスすると、貢献者の役割を持つメンバーが(フルネームとメールアドレスを事前に入力され)、確認され、チームに追加されます。

Okta SAMLセットアップ

  1. Oktaにログインしてください。
  2. アプリケーションページに移動します。
  3. Create App インテグレーション をクリックして、Oktaで新しいSAMLアプリケーションを作成します。
  4. サインイン方法として SAML 2.0 を選択してください。
  5. [次へ] をクリックします。
  6. 作成しているAirFocusアプリの名前を入力してください。
  7. 次へクリック。
    set-up-okta-scim-saml-and-sso-4.png
  8. 以下の値を設定します:
    • シングルサインオン URL: https://auth.airfocus.com/login/sso/callback/saml
    • 観客 URI(SP 実体 ID):https://airfocus.com
      • ご注意ください。米国またはAPAC地域にお住まいで、2025年9月以降に作成したアカウントの場合は、上記のURLの「airfocus.com」を「airfocus.app」に置き換えてください。
        set-up-okta-scim-saml-and-sso-5.png
  9. 属性文のセクションに移動し、以下の値を設定してください:
    • email = ユーザー.email
    • givenName = ユーザー.firstName
    • surname = ユーザー.lastName
      set-up-okta-scim-saml-and-sso-6.png
  10. ページの一番下までスクロールし、「 次へ」をクリックしてください。
  11. フィードバックページの「これは当社が作成した社内アプリです」というボックスにチェックを入れてください。
  12. 「終了」をクリックします。
    set-up-okta-scim-saml-and-sso-8.png
  13. Oktaで新しく作成したairfocusアプリで「 割り当て」 タブを選択してください。
  14. 少なくとも自分自身を許可されたユーザーとしてアプリケーションに追加していることを確認しましょう。
    • まだ使っていなければ、「Assign」機能を使ってToDoをしてください。
  15. 次に、 サインイン タブを選択します。
  16. 右端では必要に応じてスクロールし、 ビューSAMLセットアップ手順 ボタンを選択します。
  17. そこにある3つの価値に注目してください。
    set-up-okta-scim-saml-and-sso-12.png
  18. エアフォーカスにログインしてください。
  19. airfocus SAMLの設定ページに移動します。
  20. 「プロバイダー」から 「SAML SSOの設定」を選択してください。
    set-up-okta-scim-saml-and-sso-13.png
  21. 「チーム設定」へ移動してください。
  22. セキュリティ/SSOタブを選択してください。
  23. 上記のステップ17からコピー&ペーストして、以下の値を設定します:
    • IDP シングルサインオン URL: {first value from the step above}
    • IDP発行者: {second value from the step above}
    • IDP X.509証明書: {third value from the step above}
      set-up-okta-scim-saml-and-sso-14.png
  24. 「テスト」をクリックします。
  25. Oktaログインにリダイレクトされ、そこからAirFocusに戻ってすべてが正常に動作したことを確認するはずです。
    set-up-okta-scim-saml-and-sso-15.png
  26. オプションとして、「シングルサインオンの強制」チェックボックスにチェックを入れて、チーム全体でSSOログインを強制することもできます。
    • 一度有効化されると、メンバーはSAML SSOのみでログインできます。メールとパスワードのログインは無効になります。
      set-up-okta-scim-saml-and-sso-17.png
  27. 「 適用」を選択します。
     

Okta SCIMセットアップ

注: AirFocusは現在、IDプロバイダーからのパスワード同期をサポートしていません。SCIMプロビジョニングを受けたユーザーは、アカウントにアクセスするためにSAML SSO経由でAirFocusにサインインする必要があります。

アカウントでOkta SCIMを設定するには:

  1. Oktaにログインしてください。
  2. 上記の Okta SAMLセットアップ 手順で作成したAirFocusアプリにアクセスしてください。
  3. カスタムOktaアプリの 「General 」タブを選択してください。
  4. アプリの設定で編集モードに入ってください。
  5. プロビジョニングの中で「SCIM」を選択してください。
  6. 「保存」をクリックします。このタブは開いたままにしておいてください。数ステップ後にまた戻ってきます。
  7. 新しいタブでAirFocusにログインしてください。
  8. 「チーム設定」へ移動してください。
  9. セキュリティ/SSOタブを選択してください。
  10. 「 SCIMを有効にする」をクリックしてください。
  11. ベースURL、チームID、生成トークンに注目してください。
    set-up-okta-scim-saml-and-sso-19.png
  12. Oktaタブに戻ってください。
  13. Oktaでアプリケーションの「 プロビジョニング 」タブを選択してください。
  14. 「SCIM Connection」の一番右の 編集 をクリックしてください。
  15. 以下の値を設定します:
    • SCIMコネクタの基本URL:SCIMユーザー管理ページに記載されている基本URL
    • 一意の識別子 field for ユーザー: the field userName
    • プロビジョニングアクション:すべてのボックスにチェック
    • 認証モード:HTTPヘッダーヘッダー
    • 認可ベアラー:最近生成されたSCIMトークン
      configure-values-for-scim-app-in-okta.png
  16. 「 Test connector configuration 」をクリックして動作を確認します。
  17. 「 保存」を選択します。
  18. それでも「プロビジョニング」タブで「アプリへのプロビジョニング」の右側の 編集 をクリックします。
  19. 「ユーザーを作成」「ユーザー属性を更新」「ユーザーを非アクティブ化」を有効にするボックスにチェックを入れてください。
  20. 「保存」をクリックします。
    set-up-okta-scim-saml-and-sso-23.png

注: Oktaでユーザーのメールを編集し、アップデートを正しくAirFocusに適用させる場合は、「username」欄ではなく「email」欄を編集してください。ユーザー名欄を編集すると、airfocusで新しいユーザーが作成されます(これはOktaの既知の制限です)。

SCIMグループ

グループを作成するには:

  1. OktaアプリケーションでSCIMグループを有効にしているか確認してください(上記の SCIMセットアップセクション のステップ5で行います)。
  2. Oktaのディレクトリグループタブに行ってください。
  3. グループを追加をクリックします。
  4. 名前と、必要に応じて説明文を記入してください。
  5. 「 保存」を選択します。
  6. Oktaのディレクトリグループタブでグループを選択してください。
  7. グループ内で「アプリケーション」タブに移動します。
  8. 「 アプリケーションを割り当てる」をクリックします。
  9. 「エアフォーカス」の右側に 「割り当て 」を選択します。
  10. 「保存」をクリックして戻ってください。
  11. [完了] をクリックします。

OktaでSCIMグループのメンバーを割り当てる方法は、以下のいずれかの方法を用います。

  • 「People」タブから 「Assign people 」をクリックして個別に割り当ててください。
  • 「グループ」タブから、割り当てたいOktaグループ名を入力してください。

SCIMグループに人員を割り当てたら、次の手順でAirFocusと同期してください:

  1. Oktaでairfocusアプリケーションにアクセスしてください。
  2. プ ッシュグループ タブを選択してください。
  3. プ ッシュグループ ドロップダウンを選択してください。
  4. ドロップダウンから「 名前でグループを探す」を選択してください。
  5. グループ名を入力して選択してください。
  6. [保存] をクリックします。

これでOktaとAirfocusの両方で「アクティブ」として表示されるはずです。

set-up-okta-scim-saml-and-sso-34.png
set-up-okta-scim-saml-and-sso-35.png

ユーザーロール

Airfocusには、コントリビューター、エディター、管理者の3つのユーザー役割があります。これらのロールはOktaを通じてプロビジョニングできますが、Oktaはデフォルトでロールを提供しないため少し設定が必要です。動作させるには、Oktaのユーザープロファイルごとにロールを作成し、次にOkta内のairfocusアプリのユーザープロファイルを作成し、さらに相互にマッピングする必要があります。

注: ロールが設定されていない場合、各ユーザーは自動的にAirFocusの「Contributor」ロールが割り当てられます。このセクションは、Oktaを使ってユーザーロールをプロビジョニングしたい場合にのみ必要です。

ユーザーロールを設定するには:

  1. Oktaにログインしてください。
  2. ディレクトリへ移動します。
  3. ドロップダウンメニューから 「プロファイルエディター」を選択してください。
  4. Oktaの ユーザー(デフォルト) プロファイルをクリックしてください。
  5. 属性 を追加を選択します。
  6. 以下の情報で貢献者の役割を作成しましょう。これらの値は大文字を区別します。
    • データ型:boolean
    • 表示名:貢献者
    • 変数名:貢献者
    • ユーザー権限を「読み取り専用」にしておきましょう
  7. 「保存」をクリックして、もう一つ追加してください。
  8. 以下の情報でエディターロールを作成します。 これらの値は大文字を区別します。
    • データ型:boolean
    • 表示名:エディター
    • 変数名:エディター
  9. 「保存」をクリックして、もう一つ追加してください。
  10. 以下の情報で管理者ロールを作成します。これらの値は大文字を区別します。
    • データ型:boolean
    • 表示名:管理者
    • 変数名:管理者
  11. [保存] をクリックします。
  12. プロフィールエディターのページに戻ってください。
  13. airfocusユーザープロフィールを選択してください。
  14. 属性 を追加を選択します。
  15. 以下の情報で貢献者の役割を作成しましょう。これらの値は大文字を区別します。
    • データ型:string
    • 表示名:貢献者
    • 変数名:貢献者
    • 外部名:roles.^[type=='contributor'].value
    • 外部名前空間: urn:ietf:params:scim:schemas:core:2.0:ユーザー
  16. 「保存」をクリックして、もう一つ追加してください。
  17. 以下の情報でエディターロールを作成します。 これらの値は大文字を区別します。
    • データ型:string
    • 表示名:エディター
    • 変数名:エディター
    • 外部名:roles.^[type=='editor'].value
    • 外部名前空間: urn:ietf:params:scim:schemas:core:2.0:ユーザー
  18. 「保存」をクリックして、もう一つ追加してください。
  19. 以下の情報で管理者ロールを作成します。これらの値は大文字を区別します。
    • データ型:string
    • 表示名:管理者
    • 変数名:管理者
    • 外部名:roles.^[type=='アカウント管理者'].value
    • 外部名前空間: urn:ietf:params:scim:schemas:core:2.0:ユーザー
  20. [保存] をクリックします。
  21. 「属性」でマッピングを選択します。
  22. ページ上部で エアフォーカスに「Oktaユーザー 」を選択してください。
  23. 一番下までスクロールして、右の列にある新しい役割属性の行を見つけてください。
    • 「contributor」の左側に入力:(ユーザー.contributor == true) ? 「寄稿者」:「」
    • 「エディター」の左側に入力:(ユーザー.エディター == true) ? 'エディター' : ''
    • 「administrator」の左側に入力:(ユーザー.administrator == true)?'アカウント管理者' : ''
      • 注:各文の末尾にある「''は2つのシングルクォートであって、1つのダブルクォートではありません。
        okta-ユーザー-to-airfocus-role-attributes.png
  24. マッピング を保存をクリックします。
  25. アップデート を適用を選択します。

ユーザーにユーザーロールを割り当てるには、以下のステップをフォローしてください:

  1. Oktaにログインしてください。
  2. ディレクトリへ移動してください。
  3. ドロップダウンメニューから 「People」を選択します。
  4. ユーザーロールを割り当てたいユーザーを選択してください。
  5. プロフィールタブをクリックしてください。
  6. 右上の 編集 をクリックしてください。
  7. 該当するユーザーロールを割り当てます。
    • Oktaでユーザーに複数のロールが割り当てられている場合、airfocusは最も高いロール(管理者、フォローby editor、フォローby Contributor)を使用します。
    • 「未定義」と「偽」は実質的に同じです。その役割をその人に任せたくなければ、どちらを選ぶかは意味がありません。すべての役割が未定義に設定されている場合、ユーザーはデフォルトで「貢献者」役割を持ちます。
  8. 「 保存」を選択します。

これでユーザーの役割がエアフォーカスに反映されるはずです。
okta-ユーザー-role-reflected-in-airfocus.png

この記事へのフィードバックをお寄せください

この記事に関するフィードバックはありますか？体験の内容についてこちらから教えてください。

お探しの内容は見つかりましたか？

他に質問がある場合や、学んだことを共有したい場合は、当社の コミュニティ   でサポートを得て、他のユーザーと協力しましょう。