Microsoft Users

Microsoft Graph で Microsoft 365 ユーザー情報を検索

​

概要

Microsoft Users ツールでは、Microsoft 365 のメールアドレスや UPN からユーザーのディレクトリプロフィールを取得したり、各ユーザーの直属マネージャーを調べたりできます。Microsoft Graph 経由で動作します。

​

主な機能

• MICROSOFT_GET_USERS
  • メールアドレスまたは UPN のリストを Microsoft 365 ユーザープロフィールに解決します。表示名・メール・役職・部署・会社名・オフィス所在地を返します。解決できなかった識別子は notFound に返されます。
• MICROSOFT_GET_MANAGER
  • 各入力ユーザーの直属マネージャーを検索します。{ user, manager } のペアのリストを返し、マネージャーが設定されていない場合は manager が null になります。解決できなかった識別子は notFound に返されます。

​

認証

Microsoft Graph の委任された User.Read.All 権限を持つ OAuth トークンが必要です。

Jinba のシークレット設定 で Microsoft アカウント（ユーザーディレクトリ）を連携し、発行されたトークンをツールの config に指定してください。

テナント管理者の同意が必要です。 User.ReadBasic.All では不十分です — 会社名や部署の情報は User.Read.All でのみ取得可能です。Azure AD アプリ登録に委任された User.Read.All を追加し、管理者の同意を得てからご利用ください。

​

例：ユーザー情報の取得とマネージャーの検索

- id: get_users
  name: get_users
  tool: MICROSOFT_GET_USERS
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_USERS.access_token}}"
  input:
    - name: identifiers
      value:
        - "[e-mail]"
        - "[e-mail]"

- id: get_managers
  name: get_managers
  tool: MICROSOFT_GET_MANAGER
  needs: ["get_users"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_USERS.access_token}}"
  input:
    - name: identifiers
      value: "{{steps.get_users.result.users[*].userPrincipalName}}"

​

入力

​

identifiers

検索するメールアドレスまたは UPN（ユーザープリンシパル名）のリストです。以下の形式に対応しています：

• 配列: ["[e-mail]", "[e-mail]"]
• カンマ区切り文字列: "[e-mail], [e-mail]"
• JSON 配列文字列: "[\"[e-mail]\", \"[e-mail]\"]"

​

出力

​

MICROSOFT_GET_USERS

フィールド	説明
result.users[].id	Azure AD オブジェクト ID
result.users[].displayName	表示名
result.users[].mail	プライマリメールアドレス
result.users[].userPrincipalName	ユーザープリンシパル名（UPN）
result.users[].jobTitle	役職
result.users[].department	部署
result.users[].companyName	会社名
result.users[].officeLocation	オフィス所在地
result.notFound[]	解決できなかった識別子

​

MICROSOFT_GET_MANAGER

フィールド	説明
result.managers[].user	このエントリの入力識別子
result.managers[].manager	マネージャーのプロフィール（ユーザーと同じフィールド）、設定なしの場合は null
result.notFound[]	解決できなかった識別子