Rememberizer アプリの認証

Rememberizerの実装は、標準の認証コードグラントタイプをサポートしています。

アプリのユーザー認証のためのWebアプリケーションフローは以下の通りです:

  1. ユーザーがRememberizerにリダイレクトされ、自分のアカウントを認証します。

  2. ユーザーがあなたのアプリケーションで使用するモメンタムを選択します。

  3. あなたのアプリケーションがユーザーのアクセストークンを使用してAPIにアクセスします。

ステップ1. ユーザーのRememberizer identityの要求

認証と認可のプロセスを開始するために、ユーザーをRememberizerの認証サーバーにリダイレクトします。

GET https://api.rememberizer.ai/api/v1/auth/oauth2/authorize/

パラメータ:

名前説明

client_id

必須 アプリケーションのクライアントID。この値はDeveloper Hubで見つけることができます。

response_type

必須 承認コード付与のためには、codeでなければなりません。

scope

アプリケーションがユーザーを代理としてアクセス可能なリソースを識別するスコープのスペース区切りリスト。

redirect_uri

必須 認証後にユーザーが送られるアプリケーション内のURL。

ステップ2. ユーザーは自分のメメントを選択し設定する

ユーザーは、あなたのアプリで使用するメメントを選択します。

ステップ3. ユーザーはRememberizerによってあなたのサイトにリダイレクトされます

ユーザーが彼らの思い出を選択した後、Rememberizerは一時的な code パラメータおよび前のステップで提供した state パラメータであなたのサイトにリダイレクトします。一時的なコードは短時間後に有効期限が切れます。状態が一致しない場合、第三者がリクエストを作成し、プロセスを中止する必要があります。

ステップ4. 認証コードをリフレッシュトークンとアクセストークンと交換する

POST https://api.rememberizer.ai/api/v1/auth/oauth2/token/

このエンドポイントは以下の入力パラメータを取ります。

名前説明

client_id

必須 あなたのアプリケーションのクライアントID。この値はDeveloper Hubで見つけることができます。

client_secret

必須 Rememberizerから受け取ったあなたのアプリケーションのクライアントシークレット。

code

ステップ3で受け取った認証コード。

redirect_uri

必須 認証後にユーザーが送られるあなたのアプリケーションのURL。ステップ1のredirect_uriと一致する必要があります。

ステップ5. アクセストークンを使用してAPIにアクセスする

アクセストークンを使用することで、ユーザーの代わりにAPIへのリクエストを行うことができます。

Authorization: Bearer OAUTH-TOKEN
GET https://api.rememberizer.ai/api/me

例えば、curlではAuthorizationヘッダーを以下のように設定できます:

curl -H "Authorization: Bearer OAUTH-TOKEN" https://api.rememberizer.ai/api/me

参考資料

Github: https://github.com/skydeckai/rememberizer-integration-samples

Last updated