カスタムOAuth アプリケーションの作成
カスタムOAuth アプリケーションの作成
CData はOAuth アプリケーション認証情報を製品に組み込んでおり、デスクトップアプリケーションまたはヘッドレスマシン経由でExact Online に接続する際に使用できます。埋め込みOAuth アプリケーションを使用する場合、接続するために必要なことは以下のみです。- OAuthAccessToken を取得して設定します。
- 必要な設定パラメータを設定します。
(OAuthAccessToken およびその他の設定パラメータを取得および設定する方法についての情報は、「Exact Online への接続」のデスクトップ認証セクションを参照してください。)
ただし、Web 経由で接続するには、カスタムOAuth アプリケーションの作成が必要です。 また、カスタムOAuth アプリケーションは、一般的に使用される3つの認証フローをすべてシームレスにサポートするため、これらの認証フロー用にカスタムOAuth アプリケーションを作成(独自のOAuth アプリケーションクレデンシャルを使用)することもできます。
カスタムOAuth アプリケーションは、次のような場合に有用です。
- 認証ダイアログのブランディングをコントロールしたいとき
- ユーザー認証後にアプリケーションがユーザーをリダイレクトするためのリダイレクトURI をコントロールしたいとき
- ユーザーからのリクエストに対する許可をカスタマイズしたいとき
プロシージャ
デスクトップ、Web、またはヘッドレスマシンの認証フローで使用するカスタムOAuth アプリケーションを作成し、適切な接続プロパティを取得するには以下を行います。
- 作成していない場合は、Exact Online developer アカウントを作成します。
- App Center にログインします。
- [Manage Apps]->[Add a New Application]をクリックします。
- アプリケーションの名前を入力します。この名前は、ユーザに接続許可を求める際に表示されます。
- リダイレクトURI を設定します。
- デスクトップまたはヘッドレスマシン経由で接続する場合は、リダイレクトURI をhttps://oauth.cdata.com/oauth/ に設定します。
- Web 経由で接続する場合は、リダイレクトURI をユーザーがアプリケーションに接続許可を与えた後に返したいページに設定します。
- Edit をクリックします。App Center に、新しいアプリケーションのクライアントクレデンシャル、クライアントId、およびクライアントシークレットが表示されます。
接続する前に、これらのOAuth クレデンシャル、およびDivision とRegion を設定してください。