概要

コネクタ仕様

コネクタでできること

管理対象

💡 確認方法

HENNGE Access Control 管理画面の「ユーザー一覧」ページで表示されるものがユーザーです。

💡 確認方法

HENNGE Access Control 管理画面で確認できます。

・「アクセスポリシーグループ」メニューで表示されるものがアクセスポリシーグループです。

・「アクセス設定」と「許可するサービスプロバイダー」はユーザー詳細画面で確認できます。

業務アセットの作成（接続方法）

接続に必要な情報

作成手順

1. HENNGE Access Control 管理画面にアクセスする

2. [API クライアント] メニューに移動する

3. [クライアント追加] > [HAC API] をクリック

4. スコープを設定する（下記「必要な権限」を参照）

5. Descriptionを入力して [保存] をクリック

6. 表示される Client ID と Client Secret を控える

必要な権限

⚠️ ロールの割当に必要なスコープ

「全てのAPI」の「読み込み/書き込み」が必須です。個別のスコープをすべて「読み込み/書き込み」に設定してもタスク実行中に権限不足でエラーが発生します。

アカウント管理

アカウントの作成

💡 ユーザー名について

ユーザー名はHENNGE Access Control 上におけるアカウントの一意識別子であり、作成後は変更できません。

デフォルトではYESODメンバーのメールアドレスの「@」より前の部分が使用されます。

アカウントの削除

💡 無効化されたアカウントの確認方法

無効化されたアカウントは、HENNGE Access Control 管理画面のユーザー一覧画面で状態が「無効」と表示されます。

割当種別

同期する項目

対応していない項目

グループプッシュ

制限事項

レートリミット

💡 Basicプランについて

Basicプランはレートリミットが厳しいため、ユーザー数が多いとタスク実行や属性同期に時間を要する場合があります。

属性同期やタスク一覧画面で複数件のタスクにチェックを入れて実行した場合、可能な限りまとめて1回のAPIリクエストで処理するようにしているので、処理時間が気になる場合はチェックを入れてまとめて実行するようにしてください。

一括処理時のエラーの扱い

• ユーザー名やメールアドレスが、HENNGE One上の別のアカウントと重複している場合

• HENNGE One上に存在しないユーザーを更新しようとした場合

• 「同期する項目」で、HENNGE Oneに定義されていないカスタム属性IDを指定している場合

💡 YESODが送信前に検出できるエラーは他のメンバーを巻き込みません

姓・名を両方とも空にしている場合や、属性式の評価に失敗している場合など、YESODがHENNGE Oneへ送信する前に検出できるエラーもあります。これらのエラーについては、対象のメンバーのみを失敗とし、他のメンバーは巻き込まずに処理します。

主なエラー

接続・認証に関するエラー

• 発生している事象：業務アセットの接続情報に Client ID または Client Secret が入力されていないため、接続を確立できない。

• 対処方法：接続設定で Client ID と Client Secret を入力する。

• 発生している事象：入力された Client ID・Client Secret が誤っているなどの理由により、HENNGE One の認証に失敗した。

• 対処方法：HENNGE Access Control 管理画面で発行した Client ID・Client Secret が正しいかを確認し、必要に応じて再発行して設定し直す。

• 発生している事象：APIクライアントに必要なスコープが付与されていないため、操作が拒否された。

• 対処方法：「必要な権限」に記載のスコープを確認する。特に「ロール」割当を使う場合は「全てのAPI」を「読み込み/書き込み」に設定する必要がある。

同期する項目に関するエラー

• 発生している事象：新規作成しようとしたユーザー名が、HENNGE Access Control 上の別のアカウントで既に使用されている。

• 対処方法：ユーザー名（user.username）が一意になるよう「同期する項目」の式を見直す。同一ユーザー名の既存アカウントを更新してもよい場合は、タスクを再実行する。

💡 発生するケースについて

通常のアカウント作成処理では、作成前に同一ユーザー名のアカウントが存在するかを確認し、存在する場合は更新処理に遷移します。そのため、このエラーは通常の運用では発生しません。存在確認から作成リクエストまでのわずかな間に、外部から同一ユーザー名のアカウントが作成された場合にのみ発生する可能性があります。

• 発生している事象：HENNGE One 側に定義されていないカスタム属性のIDを「同期する項目」に指定したため、更新が拒否された。

• 対処方法：HENNGE One の管理画面で定義済みのカスタム属性IDと完全に一致するよう、「同期する項目」のキーを修正する。

• 発生している事象：「同期する項目」の姓・名がどちらも空に評価されたため、HENNGE Oneへ送信する前に処理を中止した。

• 対処方法：「同期する項目」の姓（）・名（）の式を見直し、少なくとも片方に値が入るようにする。

• 発生している事象：送信した値が HENNGE One 側のバリデーションに違反した。

• 対処方法：「同期する項目」の式と評価結果を確認する。指定した値がHENNGE One側の入力チェックに合致しないケースが該当する。

• 発生している事象：パスワードリセットを実行したが、パスワードが発行されていない。

• 対処方法：業務アセットの設定画面の「アカウント設定」で初期パスワードが「パスワードを発行する」に設定されていることを確認する。

タスク実行に関するエラー

• 発生している事象：割当の付与・剥奪の対象アカウントが、HENNGE Access Control 上に存在しない。

• 対処方法：対象アカウントが存在することを確認する。

• 発生している事象：アカウントの更新で、HENNGE One 側の処理完了を待つ間にタイムアウトした。

• 対処方法：時間をおいて再実行する。

⚠️ 背景と注意事項

HENNGE One には、単体のユーザーを作成・更新するAPIと、複数のユーザーをまとめて作成・更新するAPIがあります。HENNGE One コネクタでは、タスク一覧画面で複数のタスクにチェックを入れて同時に実行した際に、後者のAPIを使ってリクエストを集約し、リクエスト数と処理時間を短縮しています。

後者のAPIは処理が完了するまでに時間がかかるため、コネクタ側ではリクエスト送信後に一定時間だけ処理完了を待機します。このエラーは、その待機時間内に完了を確認できなかった場合に発生します。

タスクがエラーになった場合でも、HENNGE One 側では作成・更新処理が継続している可能性があります。アカウントの作成が成功している可能性があるので、HENNGE Access Control の管理画面でアカウントの状態を確認してください。

また、アカウント作成タスクがこのエラーで失敗した場合、初期パスワードをタスク結果から確認できません。アカウントが作成されていた場合は、パスワードリセットを実行してパスワードを再発行してください。

• 発生している事象：当該アカウントに対する操作が HENNGE One 側で失敗した。

• 対処方法：当該アカウントの「同期する項目」や割当の指定値を確認し、再実行する。

• 発生している事象：HENNGE One API のレートリミットに達し、一定回数リトライしても解消しなかった。

• 対処方法：メッセージに記載された時刻以降、またはしばらく時間をおいてからタスクを再実行する。Basicプランではレートリミットが厳しいため発生しやすい（「制限事項 > レートリミット」を参照）。

その他のエラー

• 発生している事象：HENNGE One 側でサーバーエラーが発生した。

• 対処方法：時間をおいて再実行する。継続する場合は HENNGE One 側の状態を確認する。

• 発生している事象：上記のいずれにも該当しない理由でAPI呼び出しが失敗した。

• 対処方法：ステータスコードに応じて設定・データを確認する。解消しない場合はカスタマーサクセスまでお問い合わせください。

• 発生している事象：上記のいずれにも該当しない理由でタスクの処理が失敗した。

• 対処方法：カスタマーサクセスまでお問い合わせください。