本ページでは、プロビジョニング機能を利用するための設定方法を説明します。

💡 補足
Okta の仕様変更により、本ヘルプページの内容が実際の画面や手順と一致しない場合があります。

 

プロビジョニングを設定する

シークレットトークンの発行を Acall 社に依頼する

Acall 社 の担当者にプロビジョニング用シークレットトークンの発行依頼をしてください。

受け取り次第、次の作業に進んでください。

 

SCIM アプリを追加する

Okta 管理コンソールのメニューバーから [ Applications ] > [ Applications ] をクリックし、[ Browse App Catalog ] をクリックします。

 

「SCIM 2.0 Test App (OAuth Bearer Token)」を検索して選択します。

 

[ Add Integration ] をクリックします。

 

[ Application label ] に任意のアプリ名を入力して [ Next ] をクリックし、[ Done ] をクリックしてアプリを作成します。

 

プロビジョニングオプションを選択する

作成したアプリの [ Provisioning ] タブを開き、[ Configure API Integration ] をクリックして「Enable API integration」にチェックを入れます。

以下の通り設定したら、[ Test API Configuration ] をクリックして接続を確認し、エラーがなければ [ Save ] をクリックします。

項目名	設定
SCIM 2.0 Base Url	https://api.acall.jp/scim ※ URL の最後に/を入力しないようご注意ください
OAuth Bearer Token	Acall社 から受け取ったシークレットトークン

 

[ Edit ] から [ Enable ] にすべてチェックを入れて [ Save ] をクリックします。

 

マッピング属性を追加する

メニューバーから [ Directory ] > [ Profile Editor ] > Acall プロビジョニング用アプリを選択します。

「Profile Editor」画面にて、まず「roles」属性を [ x ] ボタンで削除します。

 

次に、[ Add Attribute ] から以下の通りに属性を 1つ ずつ追加します。

⚠️ 注意
連続で登録すると失敗することがあるため、1件 ずつ [ Save ] して登録してください。

💡 補足
・「Data type」はすべて「string」を選択してください
・「Attribute type」はすべて「Personal」を選択してください
・その他の項目は既定値のままです

 

項目名	値
Display name	Primary role
Variable name	primary_role
External name	roles.^[primary=='True'].value
External namespace	urn:ietf:params:scim:schemas:core:2.0:User

 

項目名	値
Display name	Tel to Call Number
Variable name	tel_to_call_numbers
External name	phoneNumbers.^[type=='sms'].value
External namespace	urn:ietf:params:scim:schemas:core:2.0:User

 

項目名	値
Display name	Extension Number
Variable name	extension_number
External name	phoneNumbers.^[type=='work'].value
External namespace	urn:ietf:params:scim:schemas:core:2.0:User

 

項目名	値
Display name	SMS Number
Variable name	sms_number
External name	phoneNumbers.^[type=='mobile'].value
External namespace	urn:ietf:params:scim:schemas:core:2.0:User

 

項目名	値
Display name	Slack Account
Variable name	slack_account
External name	accounts.^[type=='slack'].value
External namespace	urn:ietf:params:scim:schemas:core:2.0:User

 

項目名	値
Display name	Google Account
Variable name	google_account
External name	accounts.^[type=='google'].value
External namespace	urn:ietf:params:scim:schemas:core:2.0:User

 

項目名	値
Display name	familyNamePhonetic
Variable name	family_name_phonetic
External name	name.familyNamePhonetic
External namespace	urn:ietf:params:scim:schemas:extension:wsos:2.0:User

 

項目名	値
Display name	givenNamePhonetic
Variable name	given_name_phonetic
External name	name.givenNamePhonetic
External namespace	urn:ietf:params:scim:schemas:extension:wsos:2.0:User

 

項目名	値
Display name	Additional information
Variable name	additional_information
External name	additionalInformation
External namespace	urn:ietf:params:scim:schemas:extension:wsos:2.0:User

 

マッピング設定をする

メニューバーから [ Applications ] > [ Applications ] をクリックし、Acall プロビジョニング用アプリを選択します。

[ Provisioning ] タブを開いて「To App」画面から、以下の通りにマッピングを設定します。

表に無い属性は [ × ] ボタンで削除します。

Attribute	Attribute value1	Attribute value2	Apply on
Username	-	-	-
Given name	Map from Okta Profile	firstName	Create and update
Family name	Map from Okta Profile	lastName	Create and update
Display name	Expression	user.firstName + + user.lastName	Create and update
Primary role	Expression	String.stringSwitch(user.email, "general", "admin@ex.com", "admin")	Create and update
Tel to Call Number	Expression	user.mobilePhone == null ? null : user.mobilePhone	Create and update
Extension Number	Expression	user.primaryPhone == null ? null : user.primaryPhone	Create and update
SMS Number	Expression	user.mobilePhone == null ? null : user.mobilePhone	Create and update
Slack Account	Expression	user.email	Create and update
Google Account	Expression	user.email	Create and update
Additional information	Map from Okta Profile	user.userType	Create and update

💡 補足
上記のマッピングの設定は、Profile Editor の Mapping 設定画面からでも設定できます。
参考：プロファイル エディタでOkta属性をアプリ属性にマップする

 

マルチテナント機能をご利用のお客様は、テナント管理者権限は「tenant_admin」を指定します。

💡 補足
（設定例）"admin1@example.com" をテナント管理者、"admin2@example.com" を管理者として設定する場合
String.stringSwitch(user.email, "general", "admin1@example.com", "tenant_admin", "admin2@example.com", "admin")

⚠️ 注意
テナント管理者「tenant_admin」の権限を設定する場合は、上記のマッピング設定に加えて、Acall Portal 上で該当ワーカーの権限を「テナント管理者」に変更してください。
「テナント管理者」権限に変更できない場合は、お問い合わせフォームからご連絡ください。

 

次に、[ To Okta ] 画面を開きます。

「Username」以外のすべての属性マッピングを [ × ] ボタンで削除します。

 

アプリをユーザーに割り当てる

作成したアプリの [ Assignments ] タブを開きます。

[ Assign ] から [ Assign to People ] もしくは [ Assign to Groups ] を選択します。

 

アプリに追加するユーザーもしくはグループの [ Assign ] をクリックし、[ Save and Go Back ] をクリックします。

 

追加したメンバーが「Assigned」になっていることを確認したら [ Done ] をクリックします。

 

アサイン後、自動的にプロビジョニングの処理が実行されます。

ユーザーの「External Id」に値が入っていればプロビジョニング完了です。

 

💡 補足
External Id がない場合は、一度アサインを削除し、再設定してください。