Invantive CloudでのOAuthアクセスおよびリフレッシュトークンの生成

オランダ語版へ

「Setup」メニュー(https://cloud.invantive.com/app/setup)では、Invantive Cloudが「Pre-authentication」サブメニューを提供しており、以下のオプションがあります。

  • オンプレミス利用向け
  • サポート利用向け

アクセストークン、リフレッシュトークン、またはOAuth認可コードを手動で生成する

オンプレミス利用版が最も一般的に使用されます。これにより、認可コードと、必要に応じてアクセストークン/リフレッシュトークンを、他のアプリケーションでの利用や、事前認証済み資格情報を使用したデータベース作成のために取得できます。これらは、以下のパッケージ向けの独自のOAuthクライアントID、クライアントシークレット、ログイン情報に基づいています。

  • Atlassian Confluence
  • Atlassian Jira
  • Calendly
  • Exact Online
  • Facebook
  • Fortnox
  • GitHub
  • GitLab
  • Jira Service Desk
  • Loket.nl
  • PayPal
  • PayPal test
  • Teamleader Focus
  • Teamleader Orbit
  • Twinfield
  • Visma.net Financials
  • Zoom

サポート利用版も同様に機能しますが、Invantive独自のクライアントIDとクライアントシークレットを使用します。

独自のクライアントIDを使用したいですか?その場合は、常に「For On-premise Use(オンプレミス利用向け)」バリアントを選択してください。

サポート目的でのみInvantiveに認可情報を提供したいですか?その場合は「For Support Use(サポート利用向け)」バリアントを選択してください。

この記事の残りの部分では、オンプレミス利用バリアントを前提としています。サポートバリアントもほぼ同一ですが、クライアントIDやクライアントシークレットを入力できない点が異なります。

OAuth 2.0 認可コードグラントフロー

事前認証ではOAuth 2.0認可コードグラントフローを使用します。認可コードグラントフローを進める際には、まずクライアントIDとクライアントシークレットを入力し、必要に応じて範囲を示す「スコープ」を追加します。

クラウドプラットフォームにログインすると、認可コードが発行されます。この認可コードは、アクセストークンと(プラットフォームによっては)リフレッシュトークンに交換できます。

インプリシットグラントフロー(Webページ向け)は使用されません。

OAuth 2.0の詳細については、以下を参照してください。

認可コードグラントフローを完了する

以下の例では、Exact Onlineでアクセストークンとリフレッシュトークンを取得するために必要な手順を説明します。

重要な注意事項!これらの手順は、通常システム開発者が使用する特定のアプリケーションにのみ必要です。標準的なExact Onlineリンクまたは Exact Onlineデータベースを作成したいですか?その場合は、Connect Power BI to Exact Online の手順に従ってください。

プラットフォーム上のアプリケーション登録(この場合はExact Online。プラットフォームごとに異なります)から、クライアントID、クライアントシークレット、リダイレクトURLをコピーします。

Invantive Cloudに入力すると、次のようになります。

リダイレクトURLはInvantive Cloud自体で使用されるものと異なっても構いません。たとえば、OAuthクライアントアプリケーションに登録されている内容と一致していれば、https://clientredirect.invantive.com も使用可能です。その場合は必ず「Different Redirect URI」をチェックしてください。

「Get Authorisation Code」ボタンを選択し、Exact Online上で認可を行います。

認証後、URL(https://clientredirect.invantive.com/?code=stampNL001.... yWA&state=85c1f68a-937a-48f6-9ae1-653913a423f8 のような形式)をコピーし、元のウィンドウの「Authorisation Code Return URL」フィールドに貼り付けます。

「Complete Pre-authentication」を選択します。次のウィンドウにアクセストークンとリフレッシュトークンが表示されます。

このウィンドウには、settings*.xmlファイルに含めるための接続文字列と、サンプルのsettings*.xmlファイルも含まれています。

アクセストークンとリフレッシュトークンは、たとえばPostmanで使用できるほか、Invantive Cloudデータベースを作成するための事前認証済み資格情報としても使用できます。