メインコンテンツへスキップ
Microsoft Users ツールでは、Microsoft 365 のメールアドレスや UPN からユーザーのディレクトリプロフィールを取得したり、各ユーザーの直属マネージャーを調べたりできます。Microsoft Graph 経由で動作します。
  • MICROSOFT_GET_USERS
    • メールアドレスまたは UPN のリストを Microsoft 365 ユーザープロフィールに解決します。表示名・メール・役職・部署・会社名・オフィス所在地を返します。解決できなかった識別子は notFound に返されます。
  • MICROSOFT_GET_MANAGER
    • 各入力ユーザーの直属マネージャーを検索します。{ user, manager } のペアのリストを返し、マネージャーが設定されていない場合は manager が null になります。解決できなかった識別子は notFound に返されます。

Microsoft Graphで接続する

Microsoft Graph の委任された User.Read.All 権限を持つ OAuth トークンが必要です。 Jinba のシークレット設定 で Microsoft アカウント(ユーザーディレクトリ)を連携し、発行されたトークンをツールの config に指定してください。
テナント管理者の同意が必要です。 これらのツールは委任された User.Read.All 権限を使用します(会社名や部署は User.ReadBasic.All では取得できません)。この権限は多くのテナントで管理者しか承認できません。シークレットダッシュボードからユーザーディレクトリの管理者同意リンクをコピーし、テナント管理者に一度開いてもらってください。詳細は 組織の管理者による同意 を参照してください。

ユーザープロフィールと上司を検索する

入力

identifiers

検索するメールアドレスまたは UPN(ユーザープリンシパル名)のリストです。以下の形式に対応しています:
  • 配列: ["alice@example.com", "bob@example.com"]
  • カンマ区切り文字列: "alice@example.com, bob@example.com"
  • JSON 配列文字列: "[\"alice@example.com\", \"bob@example.com\"]"

出力

MICROSOFT_GET_USERS

MICROSOFT_GET_MANAGER