初期のAPI認証フローはどのように設定できますか?

この機能を使用できるのは誰ですか?

Enterprise プランで利用可能です。

Web App でオーナーおよび管理者がご利用いただけます。

Fax.Plus API を使用するには、まず API がお使いのアカウントにアクセスするための認可を付与する必要があります。認可プロセスが完了すると、アカウントにログインできるようになります。

認証には2つの異なる方法があります:

  1. パーソナルアクセストークンを生成して使用する。
  2. OAuth 2.0 フローを使用する。
方法1: パーソナルアクセストークンを生成して使用する

パーソナルアクセストークンは、Fax.Plus APIに安全にアクセスするための認証方法として使用できます。このトークンはデジタル署名として機能し、ファックスの送信やファックスデータの取得などのアクションを可能にする、認証済みリクエストをAPIに対して行うことができます。

新しいパーソナルアクセストークンを生成するには、以下の手順に従ってください:

  1. Fax.Plusアカウントにログインし、ダッシュボードの設定 セクションに移動します。
  2. 連携タブを見つけます。
  3. Fax.Plus APIの下にある パーソナルアクセストークンの項目を見つけて、管理をクリックします。
  4. トークンを生成をクリックし、トークン名有効期限スコープ(トークンのスコープとして編集と読み取りの両方)を指定します。
  5. 今すぐパーソナルアクセストークンコピーしてください。そうしないと、二度と表示することができなくなります。
方法2: OAuth 2.0フローを使用してAPIがアカウントにアクセスすることを承認する

ステップ1: 初期認証フローを設定する

  1. Fax.Plusアカウントにログインし、ダッシュボードの設定 セクションに移動します。
  2. 連携タブを見つけます。
  3. Fax.Plus APIの下にある有効化をクリックし、以下のデータを取得します:
    • クライアントID(APIK-で始まる)
    • クライアントシークレット
    • リダイレクトURI(いずれか1つ)

      Integrations.png

  4. APIがアカウントにアクセスすることを承認するプロセスを開始するには、このステップで提供されているリンクをウェブブラウザでクリックするだけです。このリンクをクリックすると、必要な権限を付与できるプロンプトにリダイレクトされます: https://accounts.fax.plus/login?response_type=code&client_id=[client ID]&redirect_uri=[redirect URI]&scope=all

    FAX.PLUS-Authenticate-1.png

  5. 権限が付与されると、指定したURLに認証コードがURLパラメータとして付加された状態でリダイレクトされます:

    FAX.PLUS-Authenticate-2.png


ステップ2: HTTP POSTリクエストを送信する

アクセスの承認に成功したら、次のURLに対してHTTP POSTを実行できます: https://accounts.fax.plus/token?grant_type=authorization_code&client_id=[client ID]&code=[authorization code]&redirect_uri=[redirect URI].

リクエストには必ず以下のヘッダーを含めてください:

    • Content-Type:  application/x-www-form-urlencoded
    • Authorization:  Basic [base64-encoded string of "client_id:client_secret"]


FAX.PLUS-Authenticate-3.png

完了すると、1時間有効なアクセストークンと、無期限に有効なリフレッシュトークンを含むレスポンスを受け取ります。

: Fax.Plusアカウントで高度なセキュリティ管理が有効になっている場合、セキュリティ規定に従い、リフレッシュトークンは30日間のみ有効です。これは、新しいリフレッシュトークンを取得するために、30日ごとにこのプロセスを繰り返す必要があることを意味します。


ステップ3: 新しいアクセストークンを取得する

アクセストークンの有効期限が切れたら、次のURLへのHTTP POSTリクエストを通じて、リフレッシュトークンを使用して新しいアクセストークンを取得できます: https://accounts.fax.plus/token?grant_type=refresh_token&refresh_token=[refresh token]

このプロセスには、以下のヘッダーを含める必要があります:

    • Content-Type: application/x-www-form-urlencoded
    • Authorization: Basic [base64-encoded string of "client_id:client_secret"]

 

FAX.PLUS-Authenticate-4.png

 

アクセストークンを取得した後、以降のすべてのAPI呼び出しには、以下のヘッダーが必要になります:

    • Authorization:  Bearer [access token]
    • x-fax-clientid:  [client ID]
 
 
この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています
More Articles in this section