​

サインアップから Authlete サービス作成までの手順（2.x）

​

はじめに

​

手順の流れ

1. Authlete にサインアップ
2. API サービスインスタンスを作成
3. クライアントアプリ開発者コンソールにログイン
4. OAuth/OIDC クライアントを登録
5. API に接続

​

1. Authlete にサインアップ

1. Authlete サービスオーナーのサインアップページ https://so.authlete.com/accounts/signup を開きます。
2. フォームを入力し、「ログイン ID」と「パスワード」を忘れないように保管します。
3. 登録後、同じ資格情報を用いて https://so.authlete.com/accounts/login からサービス管理者コンソールにログインします。

​

2. API サービスインスタンスを作成

1. サービス管理者コンソール https://so.authlete.com/accounts/login にログインします。
2. 「サービス作成」をクリックします。
3. 任意の「サービス名」を入力し、「作成」をクリックします。
4. 確認のダイアログで「OK」をクリックします。

• 自動生成された「API キー」と「API シークレット」は、次のように用いられます。
  • クライアントアプリ開発者コンソールの「ログイン ID」と「パスワード」として。
  • 認可サーバーが Authlete API を呼び出す際のクレデンシャルとして。
• 「クライアントアプリ開発者コンソール」の URL は次の手順で使用します。

​

3. クライアントアプリ開発者コンソールにログイン

1. サービスのクライアントアプリ開発者コンソール URL（例: https://cd.authlete.com/10723797812772）にアクセスします。
2. 以下でログインします。
   • ログイン ID: API キー（例: 10723797812772）
   • パスワード: API シークレット（例: ekYoYTI84qZcpe6bXGzDwduQ1fGBYxJT8K8Tnwd7poc）

​

4. OAuth/OIDC クライアントを登録

1. 「アプリ作成」をクリックします。

• コンフィデンシャルクライアントとして動作（参考: RFC 6749: Section 2.1. Client Types）
• クライアント ID とクライアントシークレットを Authorization: Basic に指定して送信（同 2.3.1. Client Password）
• 認可レスポンスのリダイレクションエンドポイントとして https://client.example.org/cb/example.com を使用（同 3.1.2. Redirection Endpoint）

2. 「基本情報」タブで、以下を入力します。
   • クライアント名: 任意の分かりやすい名前
   • クライアントタイプ: CONFIDENTIAL

3. 「認可」タブに切り替え、以下を設定します。

4. 「作成」をクリックし、確認のダイアログで「OK」をクリックします。

​

5. API に接続

​

Linux/Mac の例

curl -s -X POST https://api.authlete.com/api/auth/authorization \
-u '<API Key e.g. 10723797812772>:<API Secret e.g. ekYoYTI84qZcpe6bXGzDwduQ1fGBYxJT8K8Tnwd7poc>' \
-H 'Content-Type: application/json' \
-d '{ "parameters": "redirect_uri=https://client.example.org/cb/example.com&response_type=code&client_id=<Client ID e.g. 12800697055611>" }'

​

Windows (PowerShell) の例

curl.exe -s -X POST https://api.authlete.com/api/auth/authorization `
-u '<API Key e.g. 10723797812772>:<API Secret e.g. ekYoYTI84qZcpe6bXGzDwduQ1fGBYxJT8K8Tnwd7poc>' `
-H 'Content-Type: application/json' `
-d '{\"parameters\" : \"redirect_uri=https://client.example.org/cb/example.com&response_type=code&client_id=<Client ID e.g. 12800697055611>\"}'

{
  "resultMessage": "[A004001] Authlete has successfully issued a ticket to the service (API Key = 10723797812772) for the authorization request from the client (ID = 12800697055611). [response_type=code, openid=false]",
  "type": "authorizationResponse",
  "resultCode": "A004001",
  "client": { /* ... */ },
  "ticket": "bi2Kxe2WW5mK_GZ_fDFOpK1bnY6xTy40Ap_8nxf-7AU",
  "action": "INTERACTION",
  "service": {
    "supportedClaims": [ /* ... */ ],
    "supportedScopes": [ /* ... */ ]
  }
}

​

まとめと次のステップ

• Authlete 2.x のサービスオーナーアカウントを作成した。
• API サービスインスタンスを作成した。
• 開発者コンソールにログインし、OAuth/OIDC クライアントを登録した。
• /api/auth/authorization API を呼び出して接続を確認した。

• Authlete 2.x API を用いた認可コードフロー全体を試す: OAuth 2.0 Basics (2.x)
• OAuth 2.0 の上に OpenID Connect と ID トークンを追加する: OIDC Basics (2.x)
• GitHub の認可サーバー実装例を調べる: 認可サーバー実装