Workplace by Facebook

このガイドでは、Workplace by Facebook向けにプロビジョニングを設定するために必要な手順を説明します。

機能

  • 新規ユーザーをインポート
  • プロファイルの更新をインポート
  • ユーザー スキーマをインポート
  • 新規ユーザーをプッシュ
  • プロファイルの更新をプッシュ
  • パスワードの更新をプッシュ
  • ユーザーの非アクティブ化をプッシュ
  • グループをプッシュ*

    *重要

    Workplace by Facebookでグループ プッシュを使用したい場合、Oktaサポートに連絡してFACEBOOK_AT_WORK_ENABLE_GROUP_PUSH_ENHANCEMENTSを有効化してもらってください。

要件

プロビジョニング機能を有効化するには、まずFacebookからOrganization ID（組織ID）を取得する必要があります。

組織IDを取得すると、以下に示すように新しいFacebookアプリケーションを作成できます。

構成の手順

  1. Oktaで、［Admin Console（管理コンソール）］>［Applications（アプリケーション）］に進み、［Add Application（アプリケーションの追加）］をクリックします。
  2. Workplace by Facebookを検索し、［Add（追加）］をクリックします。

  3. ［General Settings（一般設定）］の下で［Application label（アプリケーション ラベル）］、［SubDomain（サブドメイン）］、および［Organization ID（組織ID）］（要件）の値を入力し、［Done（完了）］をクリックします。

  4. ［Provisioning（プロビジョニング）］タブを選択して［Configure API Integration（API統合を構成）］をクリックします。

  5. ［Enable API integration（API統合を有効化）］をオンにし、［Authenticate with Workplace by Facebook（Workplace by Facebookで認証）］をクリックします。

  6. Workplace組織で新しいウィンドウが開きます。場合によってはOktaがAPIを使用できるようにFacebook管理者の資格情報を入力する必要があります。これを行うには、［Add to Workplace（Workplaceに追加）］をクリックします。［Add Okta Identity to groups（Okta Identityをグループに追加）］オプションでは、All groups（すべてのグループ）を選択する必要があります。

  7. 一連のリダイレクトの後、新規アプリケーションが構成されます。［Save（保存）］をクリックしてこのウィンドウをFacebook組織設定で閉じます。

  8. Workplace by Facebook was verified successfull（Workplace by Facebookの検証に成功しました）メッセージが表示されたら、［Save（保存）］をクリックします。
  9. 左パネルで［To App（アプリへ）］を選択し、次に有効化したいプロビジョニング機能を選択し、［Save（保存）］をクリックします。

スキーマ 検出

Workplace by Facebookはユーザーのスキーマ検出をサポートするため、ユーザー プロファイルに他の属性を追加することができます。Oktaでこれを行うには、

  1. ［Directory（ディレクトリ）］ >［Profile Editor（プロファイル エディター）］の順に進みます。
  2. 左ペインから［APPS（アプリ）］セクションを選択し、リストから目的のアプリを見つけます。
  3. 属性の一覧を確認します。必要な属性が見つからない場合、［Add Attribute（属性の追加）］をクリックして拡張された属性リストを表示します。
  4. 追加したい属性をチェックし、［Save（保存）］をクリックします。
  5. これで、Facebookとの間でこのユーザー属性の値をインポートしたりプッシュできるようになりました。

位置属性：

デフォルトでは、Facebookユーザーを作成／アップデートすると、OktaはユーザーのLocation（位置）をカンマ区切りのアドレス プロパティ（street, city, stateなど）で自動入力します。この動作がニーズに合わない場合、以下に示すようにスキーマ検出を介して［Location（位置）］フィールドを AppUserに追加し、それに従ってマップできます。

  1. ［Refresh Attribute List（属性リストを更新）］をクリックします。
  2. 属性のリストから［Location（位置）］フィールドを見つけます。
  3. それをAppUserプロファイルに追加します。
  4. OktaからWorkplace by Facebookへ［Location（位置）］フィールドのマッピングを設定します。

    例：user.city > location

トラブルシューティング

下の表に従って管理者属性のマッピングを構成します（詳しくは「Okta式言語」を参照）

シナリオ管理者属性のマッピング
管理者をFacebook at Workplaceにプッシュしない 空白
OKTAからユーザー向けに管理者のみをプッシュuser.manager
ADからインポートされたユーザー向けに管理者をプッシュgetManagerAppUser("active_directory", "facebook_at_work").userName
OKTAおよびADからユーザー向けに管理者をプッシュhasDirectoryUser() ? getManagerAppUser("active_directory", "facebook_at_work").userName : user.manager
  1. Early Access機能に進み、Enable Okta Expression Language for manager attribute mapping for Facebook at Work（Facebook at Workの管理者属性マッピング向けにOkta式言語を有効化）を有効にします。この機能は既存のアプリ インスタンスのみで利用可能です。
  2. 下の表に従って管理者属性のマッピングを構成します（詳しくは「Okta式言語」を参照）
シナリオ管理者属性のマッピング
管理者をFacebook at Workplaceにプッシュしない 空白
OKTAからユーザー向けに管理者のみをプッシュuser.manager
ADからインポートされたユーザー向けに管理者をプッシュgetManagerAppUser("active_directory", "facebook_at_work").userName
OKTAおよびADからユーザー向けに管理者をプッシュhasDirectoryUser() ? getManagerAppUser("active_directory", "facebook_at_work").userName : user.manager

エラー = このユーザーは親グループのメンバーではありません

  1. Workplace by Facebookアカウントで［Admin panel（管理者パネル）］>［People（ユーザー）］に進みます。
  2. グループのユーザーの［Account Status（アカウント ステータス）］を確認します。［Deactivated（非アクティブ化）］ステータスのユーザーは存在しないはずです。
  1. Workplace by Facebookアカウントで［Admin panel（管理者パネル）］>［People（ユーザー）］に進みます。

  2. 目的のグループを見つけ、グループに［Join as Admin（管理者として参加）］を選択します。

制限事項

現行のWorkplace Facebookコネクターは1つのADドメインから管理者／従業員関係を取得することができますが、Oktaを使用したプロビジョニングをFacebookに使用して複数のADドメインからユーザーデータを引き出す場合、複数のドメインからこれらの関係を取得することができないため、Oktaはユーザーをプロビジョニングできません。この既知の制限事項は、近い将来解決される予定です。