SmartHRとの連携を追加する
SmartHR連携の手順
SmartHRとの連携方法には「OAuthで連携」と「アクセストークンで連携」の2パターン存在します。
SmartHRの従業員情報の作成・変更を行う場合は「アクセストークンで連携」が必要です。
本ヘルプでは「アクセストークンで連携」の手順を案内します。
-
［アプリカタログ］から「SmartHR」を探し、［連携を追加］をクリックします。
- ［アクセストークンで連携］をクリックすると以下モーダルが表示されるので、「ドメイン」「アクセストークン」を入力し［連携を追加］をクリックします。
ドメインの確認方法
SmartHRにアクセスするURLを確認してください。例えばアクセスしているURLが「https://xxxxxx.smarthr.jp/」である場合、「ドメイン」は「xxxxxx.smarthr.jp」です。
アクセストークンの確認方法
詳しくは下記SmartHR公式サイトもご参照ください。
- SmartHRにアクセスし、管理者アカウントでログインします。
-
［共通設定］をクリックします。
-
［外部システム連携］>［アクセストークン］>［新規発行］をクリックします。
-
「アクセストークン名」には「IT Expert Services SaaS管理連携用」などのわかりやすい名前を入力し、画面下にスクロールします。
- ［リソースの制限］および［従業員項目のアクセス許可］からIT Expert Services SaaS管理がアクセス可能なアカウント情報を選択できます。
最低限のアカウント同期には以下の参照権限が必須となるので、必ずチェックを入れます。
・ユーザーID
・姓
・名
・メールアドレス
・在籍状況
・従業員招待フォーム
・部署
・役職
例えば、［生年月日］と［戸籍上の性別］の［参照］のチェックを外すと、fIT Expert Services SaaS管理上でSmartHRアカウントの生年月日と性別が確認できなくなります。
この設定はアクセストークン発行後もSmartHRのアクセストークン管理画面から編集が可能です。
すべてにチェックを入れた状態でアクセストークン発行いただき、不要なものを後から外すことができます。
-
設定が完了したら、画面下部の［登録］をクリックします。
-
アクセストークンが表示されます。
※Webhookについて
Webhookは、初回のアクセストークンの連携時には何も設定いただかずに自動的に連携が行われる仕様になっておりますが、何らかの理由でアクセストークンを再度発行した場合は、Webhookも設定し直す必要があります。
詳しくは下記Webhook公式サイトもご参照ください。
-
誤操作防止のためにSmartHR上にある、既存のIT Expert Services SaaS管理用WebhookのURLを削除します。［共通設定］> ［外部システム連携］>［Webhook］> ［操作］> ［削除］をクリックします。
-
下記モービルが表示されるので、［削除］をクリックします。
-
再度IT Expert Services SaaS管理上でWebhookを設定します。IT Expert Services SaaS管理にログインし［マイアプリ］>［SmartHR］>［設定］>［Webhook］>［...］>［編集］をクリックします。
-
下記モービルが表示されるので、トークンの中身を消去し、空の状態で［送信］をクリックします。
-
トークンを削除したWebhookの［URL］をコピーします。
-
SmartHR上のWehbook画面で「Webhookを登録する」を押し、コピーしておいた「URL」を貼り付け、［シークレットトークンをランダム作成］をクリックします。
-
下にスクロールし、［送信のトリガーとなるイベント］にチェックを入れて［追加］をクリックします。
-
先ほど発行した［シークレットトークン］をIT Expert Services SaaS管理にログインし［Webhook］の［トークン］に入力します。