Forge API を利用するアプリの登録とキーの取得

RESTful API でクラウドにアクセスする際には、アクセストークンを取得する必要があります。また、アクセストークンを取得するためには、あらかじめデベロッパポータルにサインインして、Client ID と Client Secret（別名：Consumer Key と Consumer Secret）を取得しておく必要があります。

Autodesk Forge Platform API で使用出来る API も増加して、デベロッパポータルのデザインも変更されていますので、改めて、アプリの登録とキーの取得についてまとめておきたいと思います。

さて、一般的なクラウドサービスでは、クラウドにアクセスするために「ログイン」または「サインイン」と呼ばれるアカウント認証が必要なのはご存じのとおりです。API を使ってクラウドにアクセスする場合にも、もちろん、アカウント認証に代わる処理が必要となります。ただ、ここで扱うことになるのは、ユーザ名やパスワードではありません。開発者に割り当てられた Client ID と Client Secret を利用して、OAuth2 仕様に基づいたアクセス許可を得ることで、オートデスクが管理するストレージにアクセスします。

ここで記載しているのは、2019年4月9日現在(改定) のものです。今後、画面構成が変わる可能性があります。ご注意ください。

Client ID と Client Secret の取得手順

Client ID と Client Secret を取得するには、はじめに Forge ポータル（https://forge.autodesk.com）にアクセスします。
Forge ポータルにアクセスすると、画面の右上に [SIGN IN] ボタンが表示されます。既に Autodesk ID をお持ちであれば、[SIGN IN] をクリックしてサインインしてください。Autodesk ID をお持ちでない場合には、サインアップが必要です。サインアップは、下記の 3. へ、Autodesk ID を持ちの場合には、8. へ進んでください。
Autodesk ID をお持ちでなければ、[アカウントを作成] をクリックして Autodesk ID を作成してください。Autodesk ID は、無償でどなたでも作成することが出来ます。
[アカウントを作成] 画面が表示されます。各項目の入力後、この画面を終了するには、「Autodesk Web Service API サービス使用条件およびAutodesk プライバシーステートメントに同意します。」にチェックする必要があります。リンクから内容をご確認の上、同意可能な場合にはチェックボックスにチェックを入れてください。
次の画面が表示された場合には、入力したメールボックスにメールアドレス確認用のメールが届いています。メールボックス（受信トレイ）を確認してみてください。
メールボックスに確認メールが届いていたら、[電子メールを確認] をクリックしてください。
アカウントの作成が完了すると次のページが表示されるので、[完了] をクリックしてください。
Forge ポータルの [SIGN IN] から作成した Autodesk ID でサインインします。2 Step Verification、あるいは 2 段階認証のガイドが表示されたら、Forge の 2 段階認証を参考に必要に応じて 2 段階認証の設定をおこなってください。
初めてサインインをすると、Forge トライアル期間（1 年間）の利用後の課金（クラウドクレジットの消費）に必要な会社名、肩書、国名、郵便番号の入力画面に遷移します。すべての項目を入力して [SUBMIT] をクリックします。
サインインが完了すると、右上に Autodesk ID のアカウント名が表示されます。アカウントのメニューから [My Apps] をクリックしてください。
My Apps 画面に移動したら、アプリを登録するために [CREATE APP] をクリックします。
表示されるページ上部の部分で、登録するアプリで使用する API を選択します。ここでは、Model Derivative API と Data Management API をクリックして選択します。なお、API の選択は、アプリ登録後にも変更することが出来ます。
ページ下部にアプリの情報を入力します。上から、アプリ名（App Name）、アプリの説明（App description）、コールバック URL（Callback URL）、自身の持つ Web サイトの URL（Your Web Site URL）を入力して、[CREATE APP] をクリックしてください。なお、コールバック URL は、3-legged OAuthで利用する URL を指しますが、A360 や BIM 360 Docs、Fusion Team のユーザストレージにアクセスしない限り不要です。ここではダミー入力で結構です。
[Create App] をクリックしてアプリが登録されると、画面上にアプリの情報とともに、Client ID と Client Secret が表示されるはずです。Client Secret は既定値で非表示になっていますが、目アイコンをクリックすることで画面に表示されます。もう一度、目アイコンをクリックすると非表示になります。

これで、アプリの登録と、そのアプリ用に割り当てられた Client ID と Client Secret の取得が完了です。この Client ID と Client Secret は、ユーザ名とパスワードに相当するもので、アプリを開発する開発者を特定するものとなります。もちろん、通常公開すべきものではありませんので、開発者は外部に漏れないよう注意してください。

画面下部の [EDIT >] をクリックすれば、いつでもアプリ内容を変更することが可能です。なお、 Client Secret は [REGENERATE] で再生成することが出来ます。登録したアプリは、アプリ自体を削除したり、登録アプリの内容を変更することも可能です。

-Toshiaki Isezaki