(WebAPI)OAuth Bearer Token (Access Token) の取得方法について

Last Update:

(※ 2016 年 12 月 13 日に Japan Office Developer Support Blog に公開した情報のアーカイブです。)

こんにちは、Office Developer サポートの森　健吾 (kenmori) です。

今回の投稿では、Access Token を取得する簡単なツールの作成方法をご紹介します。

開発およびデバッグを進める上で、以下のように Azure AD にアプリケーションを登録し、ADAL (ライブラリ) を使用した C# アプリケーションを開発しておくことで、アクセス トークンを常に取得できる状況にしておくと便利だと思います。

今回ご紹介する方法は、たくさんあるうちの 1 つの方法ですが、この手法に慣れていない方を対象に可能な限り簡略化した手順にさせていただきましたので、是非ご参考にしてください。

1. Azure Portal 側の操作

  1. Azure Portal (https://portal.azure.com) にアクセスします。
  2. Azure Active Directory は、2016/12/12 時点でプレビュー版なのでクラシック ポータルに移動します。
    ※ プレビューが解除されたら、新ポータルでそのまま操作ください。

  1. [Azure Active Directory] – [<テナント名>] – [アプリケーション]と遷移します。

4) [追加] をクリックします。

  1. [組織で開発中のアプリケーションを追加] をクリックします。

  2. 任意の名前を指定し、”ネイティブ クライアント アプリケーション” を選択して、右矢印をクリックします。

  1. リダイレクト URI に任意の値を指定します。

  1. [完了] をクリックします。

  2. できあがったアプリケーションが開かれるので [構成] をクリックします。

  3. 画面下にスクロールし、”他のアプリケーションに対するアクセス許可” にて、[アプリケーションの追加] をクリックします。

  4. 今回開発する Access Token 取得用アプリケーションに取得させたいアプリケーション アクセス許可を選びます。
     11-1) Microsoft Graph の右の (+) アイコンをクリックしてチェックアイコンをクリックします。

 11-2) デリゲートされたアクセス許可をクリックし、以下のような内容をチェックします。

   例.
     ・Have full access to all files user can access (任意)
・Sign users in (必須)

(※自身のデバッグ用のアプリなので、便宜上大量にチェックしても問題ないと思います。)

  1. 画面下の [保存] をクリックします。

  2. 画面上にスクロールして、クライアント ID の右のコピー ボタンをクリックし、クライアント ID をクリップ ボードに取得し、控えておきます。クライアント ID の形式は xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx のような形式です。

2. Visual Studio 側の操作

  1. Visual Studio を起動し、Windows フォーム アプリケーションを開始します。
  2. 以下のような入力コントロールを配置します。

  1. ソリューション エクスプローラーより [参照] を右クリックして、NuGet パッケージの管理をクリックします。

  2. ADAL を検索して、[インストール] をクリックします。

  1. ダイアログが表示されたら、[OK] や [同意する] などを適宜クリックします。
  2. Form.cs などをダブルクリックして、ボタンをダブルクリックし、コード ビューに遷移します。
  3. 以下のようなコードを実装します。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
using Microsoft.IdentityModel.Clients.ActiveDirectory;
using System;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace GetAccessTokenForDebug
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private async void button1_Click(object sender, EventArgs e)
        {
            string resource = textBox1.Text;
            string clientid = textBox2.Text;
            string username = textBox3.Text;
            string password = textBox4.Text;
            string AccessToken = await GetAccessToken(resource, clientid, username, password);
            textBox5.Text = AccessToken;
            if (checkBox1.Checked)
            {
                Clipboard.SetText(AccessToken);
            }
        }

        private async Task<string> GetAccessToken(string resource, string clientid, string username, string password)
        {
            AuthenticationContext authenticationContext = new AuthenticationContext("https://login.microsoftonline.com/common");
            AuthenticationResult authenticationResult = await authenticationContext.AcquireTokenAsync(
                resource,
                clientid,
                new UserPasswordCredential(username, password)
            );
            return authenticationResult.AccessToken;
        }
    }
}
  1. アプリケーションを実行します。

  1. AccessToken が取得できることを確認します。
    ここで取得した Access Token を Fiddler などで、Microsoft Graph などを試す際にご使用ください。

今回の投稿は以上となります。

本情報の内容 (添付文書、リンク先などを含む) は、作成日時点でのものであり、予告なく変更される場合があります。