{
'task_name': 'ad_task', 
'task_details': {
 'ad_host': '<HOST_NAME>',
 'ad_dn': '<DN OF THE AD MACHINE>',
 'activity_name': 'create_object',
 'object_name': '<OBJECT_NAME>',
 'organization_unit': '<ORGANIZATION_UNIT_NAME>',
 'object_type': 'user',
 'properties': {
 'ObjectClass': 'user',
 'givenName': '<DISPLAY NAME OF THE USER>'
 }
},
    'credential': {
 'name': '<CREDENTIAL_NAME>'
    }
}

{
    'task_name': 'ad_task', 
    'task_details': {
 'ad_host': '<HOST_NAME>',
 'ad_dn': '<DN OF THE AD MACHINE>',
 'activity_name': 'create_object',
 'object_name': '<OBJECT_NAME>',
 'organization_unit': '<ORGANIZATION_UNIT_NAME>',
 'object_type': 'computer',
 'properties': {
 'ObjectClass': 'computer',
 'givenName': '<DISPLAY NAME OF THE OBJECT>'
 }
},
'credential': {
 'name': '<CREDENTIAL_NAME>'
}
}

{
    'task_name': 'ad_task', 
    'task_details': {
 'ad_host': '<HOST_NAME>',
 'ad_dn': '<DN OF THE AD MACHINE>',
 'activity_name': 'create_object',
 'object_name': '<OBJECT_NAME>',
 'organization_unit': '<ORGANIZATION_UNIT_NAME>',
 'object_type': 'group',
 'properties': {
 'ObjectClass': 'group',
 'givenName': '<DISPLAY NAME OF THE GROUP>'
 }
},
'credential': {
 'name': '<CREDENTIAL_NAME>'
}
}

グループへのユーザー追加

{
'task_name': 'ad_task', 
'task_details': {
 'ad_host': '<HOST_NAME>',
 'ad_dn': '<DN OF THE AD MACHINE>',
 'activity_name': 'create_object',
 'object_name': '<OBJECT_NAME>',
 'organization_unit': '<ORGANIZATION_UNIT_NAME>',
 'object_type': 'group',
 'properties': {
 'ObjectClass': 'group',
 'givenName': '<DISPLAY NAME OF THE GROUP>'
 }
},
'credential': {
 'name': '<CREDENTIAL_NAME>'
}
}

{
'task_name': 'ad_task', 
'task_details': {
 'ad_host': '<HOST_NAME>',
 'ad_dn': '<DN OF THE AD MACHINE>',
 'activity_name': 'disable_user',
 'user_name': '<USER_NAME>'
},
'credential': {
 'name': '<CREDENTIAL_NAME>'
}
}

{
'task_name': 'ad_task', 
'task_details': {
 'ad_host': '<HOST_NAME>',
 'ad_dn': '<DN OF THE AD MACHINE>',
 'activity_name': 'enable_user',
 'user_name': '<USER_NAME>'
},
'credential': {
 'name': '<CREDENTIAL_NAME>'
}
}

{
'task_name': 'ad_task', 
    'task_details': {
 'ad_host': '<HOST_NAME>',
 'ad_dn': '<DN OF THE AD MACHINE>',
 'activity_name': 'unlock_account',
 'user_name': '<USER_NAME>'
},
credential': {
 'name': '<CREDENTIAL_NAME>'
}
}

{
    'task_name': 'ad_task', 
    'task_details': {
 'ad_host': '<HOST_NAME>',
 'ad_dn': '<DN OF THE AD MACHINE>',
 'activity_name': 'reset_password',
 'user_name': '<USER_NAME>',
 'password': '<PASSWORD>',
'is_unlock_account': true,
 'is_user_reset_password_next_logon': true
},
'credential': {
 'name': '<CREDENTIAL_NAME>'
}
}

2. Bridge経由でADサーバーに接続できない場合の確認事項

• Bridgeホストマシンがネットワーク経由でADサーバーと通信できるか確認してください。
• ホスト名とポート（LDAPは389／LDAPSは636）が正しいことを確認してください。
• 通信がファイアウォール制限やプロキシ設定によってブロックされていないことを確認してください。
• Bridgeサービスが実行中で、ネットワークアクセス権があることを確認してください。
  

3. AD操作の実行中に「Invalid credentials」が表示される場合の対処方法

• QntrlでAD認証情報を作成した際に指定したUser DNとパスワードを再確認してください。

• ADユーザーアカウントに、作成、変更、削除の操作を実行するために必要な権限があることを確認してください。

• ADで認証情報を最近更新またはリセットした場合は、Qntrlでも更新してください。
  

4. LDAPS接続が失敗する場合の修正方法

• AD Lightweight Directory Services（AD LDS）がADサーバーで有効になっていることを確認してください。
• LDAPSのSSL証明書が有効で、Bridgeマシンにインポートされていることを確認してください。
• Bridge/conf/ldap-config.propertiesファイルを開き、次の設定が正しいことを確認してください。
• bridge.ldap.use.ssl=true
  bridge.ldap.ssl.certificate.path=<PATH_TO_CERTIFICATE>
• 拡張子が.pfxの証明書を使用している場合は、追加する前にパスワードを暗号化してください。
• bridge.ldap.ssl.certificate.password=<ENCRYPTED_PASSWORD>
• 設定を更新した後、Bridgeサービスを再起動してください。

5. LDIFスクリプトが失敗する場合の原因

• スクリプトがLDIF形式に従っており、変数を%q_<variable_name>%の形式で使用していることを確認してください。

• BridgeペイロードまたはCircuit変数で変数を参照する場合は、%q_%プレフィックスを省略し、使用するのはsnake_caseの変数名のみにしてください。

• 例：スクリプト内 → %q_mail_id%、ペイロード内 → mail_id

• 実行するLDIFタスクがその操作に対応していることを確認してください。（LDIFスクリプトでは読み取り／フィルター操作はサポートされていません。）
  

6. 失敗したAD実行の詳細ログの確認方法

• リアルタイムの実行詳細を確認するには、［Bridgeエージェント］→［コアサービス］→［ログ］を開きます。

• 詳細な分析を行うには、［Bridgeエージェント］→［ログ］→［ログファイルをダウンロード］からログファイルをダウンロードします。

• ログには、ローカルのBridge/logs/からもアクセスできます。
  

7. Bridgeサービスは実行中だがタスクが実行されない場合の対処方法

1. 接続を更新するため、Bridgeサービスを再起動してください。
   
2. 認証または証明書関連のエラーがないか、Bridgeログ（Bridge/logs/bridge.log）を確認してください。
   
3. 問題が解消しない場合は、Qntrlの［設定］→［Bridge］→［インストール済みBridge］でBridgeエージェントが正しく関連付けられているか確認してください。