MS Teams client の作り方

まず以下を実行し、 device code 登録に必要な情報を取得します。

$ echo 'client_id={CLIENT_ID}&scope=openid%20offline_access%20https%3A%2F%2Fgraph.microsoft.com%2FChannelMessage.Send' | curl 'https://login.microsoftonline.com/{TENANT_ID}/oauth2/v2.0/devicecode' -H 'Content-Type: application/x-www-form-urlencoded' -d @-

ここで、 {CLIENT_ID} , {TENANT_ID} には、自分の環境に合せて設定してください。

また、scope には必要なパーミッションのスコープを指定してください。

上記の例は、所定のチャネルに新規登録する際に必要なパーミッション(ChannelMessage.Send)です。

これを実行すると、次のようなレスポンスを得られます。

 {
  "user_code":"??????????????????",
  "device_code":"??????????????????",
  "verification_uri":"https://microsoft.com/devicelogin",
  "expires_in":900,
  "interval":5,
  "message":"To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code H6YXVV74E to authenticate."
}

ここで、 user_code と device_code をメモって起きます。

user_code は認証させたいユーザに表示し、 device_code は teams client を開発する側で一時的に保持しておきます。

次に teams client を認証させたいユーザが以下の URL にブラウザでアクセスします。

<https://microsoft.com/devicelogin>

ここにアクセスすると、コード入力画面が表示されるので、 user_code を入力します。

user_code を入力すると、直ぐに Azure の認証画面に移るので ID/PASS を入力し、 teams client にアクセスを認可します。

つぎに、token を取得します。

echo 'grant_type=urn:ietf:params:oauth:grant-type:device_code&client_id={CLIENT_ID}&device_code={DEVICE_CODE}' | curl -X POST https://login.microsoftonline.com/organizations/oauth2/v2.0/token -H 'Content-Type: application/x-www-form-urlencoded'  -d @-

ここで {CLIENT_ID} , {DEVICE_CODE} に client_id と device_code を指定します。

成功すると、次のレスポンスが返ってきます。

{
   "token_type":"Bearer",
   "scope":"openid profile email https://graph.microsoft.com/ChannelMessage.Send",
   "expires_in":3749,
   "ext_expires_in":3749,
   "access_token":"?????????????",
   "refresh_token":"???????????",
   "id_token":"??????????????"
}

この access_token と refresh_token が Graph API を利用する際に必要になります。

なお、 access_token は短い間隔で expire し、 refresh_token を使って expire した access_token を取り直して利用する運用方法になります。

よって、refresh_token は非常に重要な情報です。

refresh_token 自体も、一定期間で expire するようです。

ここまでの作業を一定時間内で行なう必要あります。

前述の通り access_token は短かい時間で expire するので、 refresh token で取り直す必要があります。

以下を実行すると access_token を取り直せます。

echo 'client_id={CLIENT_ID}&scope=https%3A%2F%2Fgraph.microsoft.com%2FChannelMessage.Send&refresh_token={REFRESH_TOKEN}&grant_type=refresh_token' | curl 'https://login.microsoftonline.com/organizations/oauth2/v2.0/token' -d @- -H 'Content-Type: application/x-www-form-urlencoded'

成功すると以下が返ります。

{
   "token_type":"Bearer",
   "scope":"openid profile email https://graph.microsoft.com/ChannelMessage.Send",
   "expires_in":4745,
   "ext_expires_in":4745,
   "access_token":"????????????????",
   "refresh_token":"???????????????????",
   "id_token":"?????????????????????"
}

Graph API を利用するには access token が必要です。

Graph API の URL アクセス時の HTTP header に、以下を指定してください。

Authorization: Bearer {ACCESS_TOKEN}