---
title: "Apache APISIX OpenID Connectプラグインを使用した集中型ID認証 - API7.ai"
description: "Apache APISIXのOpenID Connectプラグインを使用してOkta認証を設定する方法は..."
url: "https://api7.ai/ja/blog/how-to-use-apisix-auth-with-okta-2"
---

[Blog](https://api7.ai/ja/blog)

[Products](https://api7.ai/ja/category/products)[Technology](https://api7.ai/ja/category/technology)[Ecosystem](https://api7.ai/ja/category/ecosystem)[Case Study](https://api7.ai/ja/category/usercase)[Team & Community](https://api7.ai/ja/category/community)

Search

⌘ + K

[Blog](https://api7.ai/blog)

Ecosystem

# Apache APISIX OpenID Connectプラグインを使用した集中型ID認証

API7.ai

September 7, 2021

[Ecosystem](https://api7.ai/category/ecosystem)

Apache APISIXのOpenID Connectプラグインを使用してOkta認証を設定するのは、簡単な3ステップのプロセスです。これにより、従来の認証モードから集中型ID認証モードに切り替えることができます。以下のセクションでは、Apache APISIXのOpenID Connectプラグインを使用してOkta認証を設定する手順を説明します。

集中型ID認証モードは、従来の認証モードと比較して以下の利点があります：

1. 集中型ID認証は、アプリケーション開発プロセスを簡素化します。
2. 集中型ID認証は、ビジネスのセキュリティを向上させます。

## 前提条件

使用するためのOktaアカウントを準備してください。

## ステップ1: Oktaの設定

1. Oktaアカウントにログインし、「Create App Integration」をクリックしてOktaアプリケーションを作成します。 ![Create App Integration](https://static.api7.ai/2022/10/03/633a432f3f24b.png?imageMogr2/format/webp)
2. サインインメソッドとして「OIDC- OpenID Connect」を選択し、アプリケーションタイプとして「Web Application」を選択します。 ![Create a new App Integration](https://static.api7.ai/2022/10/03/633a432f490b8.png?imageMogr2/format/webp)
3. ログインとログアウトのリダイレクトURLを設定します。「Sign-in redirect URIs」は、ログイン成功後にリダイレクトが許可されるリンクで、「Sign-out redirect URIs」は、ログアウト成功後にリダイレクトされるリンクです。この例では、ログインリダイレクトとログアウトリダイレクトのURIを両方とも<http://127.0.0.1:9080/>に設定します。 ![Set the redirect URL for login and logout](https://static.api7.ai/2022/10/03/633a432e8c4ee.png?imageMogr2/format/webp)
4. 設定が完了したら、「Save」をクリックして変更を保存します。 ![save the changes](https://static.api7.ai/2022/10/03/633a432f09398.png?imageMogr2/format/webp)
5. アプリケーションのGeneralページにアクセスして、以下の設定を取得します。これは、Apache APISIX OpenID Connectを設定するために必要です。

- Client ID: アプリケーションIDで、以下のclient\_idに対応します。
- Client secret: アプリケーションキーで、以下のclient\_secretに対応します。
- Okta domain: アプリケーションが使用するドメイン名で、以下の{ISSUER}に対応します。

![obtain configuration](https://static.api7.ai/2022/10/03/633a432f0dc24.png?imageMogr2/format/webp)

## ステップ2: Apache APISIXのインストール

### 依存関係のインストール

Apache APISIXの実行環境には、NGINXとetcdの依存関係が必要です。Apache APISIXをインストールする前に、使用しているオペレーティングシステムに応じて依存関係をインストールしてください。CentOS7、Fedora 31 & 32、Ubuntu 16.04 & 18.04、Debian 9 & 10、およびMacOSの依存関係インストール手順を提供しています。詳細については、[Install Dependencies](https://apisix.apache.org/docs/apisix/install-dependencies/)を参照してください。

### RPMパッケージによるインストール（CentOS 7）

このインストール方法はCentOS 7に適しています。以下のコマンドを実行してApache APISIXをインストールしてください。

```
sudo yum install -y https://github.com/apache/apisix/releases/download/2.7/apisix-2.7-0.x86_64.rpm
```

### Dockerによるインストール

詳細については、[Installing Apache APISIX with Docker](https://apisix.apache.org/docs/apisix/how-to-build/#installation-via-docker)を参照してください。

### Helm Chartによるインストール

詳細については、[Installing Apache APISIX with Helm Chart](https://apisix.apache.org/docs/apisix/how-to-build/#installation-via-helm-chart)を参照してください。

### ソースリリースによるインストール

1. `apisix-2.7`という名前のディレクトリを作成します。

   ```
   mkdir apisix-2.7
   ```

2. Apache APISIX Releaseのソースパッケージをダウンロードします。

   ```
   wget https://downloads.apache.org/apisix/2.7/apache-apisix-2.7-src.tgz
   ```

   Apache APISIXの公式ウェブサイトからもApache APISIX Releaseのソースパッケージをダウンロードできます。[Apache APISIX Official Website - Download Page](https://apisix.apache.org/downloads/)には、Apache APISIX、APISIX Dashboard、および[APISIX Ingress Controller](https://github.com/apache/apisix-ingress-controller)のソースパッケージも提供されています。

3. Apache APISIX Releaseのソースパッケージを解凍します。

   ```
   tar zxvf apache-apisix-2.7-src.tgz -C apisix-2.7
   ```

4. 実行に必要なLuaライブラリをインストールします。

   ```
   # apisix-2.7ディレクトリに移動
   cd apisix-2.7
   # 依存関係を作成
   make deps
   ```

### 依存関係の初期化

以下のコマンドを実行して、NGINX設定ファイルとetcdを初期化します。

```
# NGINX設定ファイルとetcdを初期化
make init
```

## ステップ3: Apache APISIXを起動し、対応するルートを設定

1. 以下のコマンドを実行してApache APISIXを起動します。

   ```
   apisix start
   ```

2. ルートを作成し、OpenID Connectプラグインを設定します。以下のコード例では、Apache APISIX Admin APIを使用してルートを作成し、アップストリームパスをhttpbin.orgに設定します。httpbin.orgは、リクエストを受信して応答するシンプルなバックエンドサービスです。以下では、httpbin.orgのgetページを使用します。詳細については、[http bin get](http://httpbin.org/#/HTTP_Methods/get_get)を参照してください。具体的な設定項目については、[Apache APISIX OpenID Connect Plugin](https://apisix.apache.org/docs/apisix/plugins/openid-connect/)を参照してください。

OpenID Connectの設定フィールドは以下の通りです：

| フィールド                                    | デフォルト値                | 説明                                                                                                                             |
| ---------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| client\_id                               | ""                    | OAuthクライアントID。                                                                                                                 |
| client\_secret                           | ""                    | OAuthクライアントシークレット。                                                                                                             |
| discovery                                | ""                    | アイデンティティプロバイダーのサービスディスカバリーエンドポイント。                                                                                             |
| scope                                    | openid                | アクセスするリソースのスコープ。                                                                                                               |
| relm                                     | apisix                | WWW-Authenticateレスポンスヘッダーの認証情報を指定します。                                                                                          |
| bearer\_only                             | false                 | リクエストヘッダーのトークンをチェックするかどうか。                                                                                                     |
| logout\_path                             | /logout               | ログアウトURI。                                                                                                                      |
| redirect\_uri                            | request\_uri          | アイデンティティプロバイダーがリダイレクトするURIで、デフォルトはリクエストアドレスです。                                                                                 |
| timeout                                  | 3                     | リクエストのタイムアウト時間で、単位は秒です。                                                                                                        |
| ssl\_verify                              | false                 | アイデンティティプロバイダーのSSL証明書を検証します。                                                                                                   |
| introspection\_endpoint                  | ""                    | アイデンティティプロバイダーのトークン認証エンドポイントのURLで、空白の場合はdiscoveryから抽出されます。                                                                     |
| introspection\_endpoint\_auth\_method    | client\_secret\_basic | トークンイントロスペクションの認証方法の名前。                                                                                                        |
| public\_key                              | ""                    | 認証トークンの公開鍵。                                                                                                                    |
| token\_signing\_alg\_values\_expected    | ""                    | 認証トークンのアルゴリズム。                                                                                                                 |
| set\_access\_token\_header               | true                  | リクエストヘッダーにアクセストークンを含めるかどうか。                                                                                                    |
| access\_token\_in\_authorization\_header | false                 | アクセストークンをAuthorizationヘッダーに含めるかどうか。この値がtrueに設定されている場合、アクセストークンはAuthorizationヘッダーに含まれ、falseに設定されている場合はX-Access-Tokenヘッダーに含まれます。 |
| set\_id\_token\_header                   | true                  | X-ID-TokenリクエストヘッダーにIDトークンを含めるかどうか。                                                                                            |
| set\_userinfo\_header                    | true                  | X-Userinfoリクエストヘッダーにユーザー情報を含めるかどうか。                                                                                            |

```
curl  -XPOST 127.0.0.1:9080/apisix/admin/routes -H "X-Api-Key: edd1c9f034335f136f87ad84b625c8f1" -d '{
    "uri":"/*",
    "plugins":{
        "openid-connect":{
            "client_id":"{YOUR_CLIENT_ID}",
            "client_secret":"{YOUR_CLIENT_SECRET}",
            "discovery":"https://{YOUR_ISSUER}/.well-known/openid-configuration",
            "scope":"openid profile",
            "bearer_only":false,
            "realm":"master",
            "introspection_endpoint_auth_method":"client_secret_post",
            "redirect_uri":"http://127.0.0.1:9080/"
        }
    },
    "upstream":{
        "type":"roundrobin",
        "nodes":{
            "httpbin.org:80":1
        }
    }
}'
```

## 検証

1. "<http://127.0.0.1:9080/get>"にアクセスすると、OpenID Connectプラグインが有効になっているため、ページはOktaのログインページにリダイレクトされます。 ![visit Okta login page](https://static.api7.ai/2022/10/03/633a432ea1fd3.png?imageMogr2/format/webp)

2. ユーザーのOktaアカウントのユーザー名とパスワードを入力し、「Sign In」をクリックしてOktaアカウントにログインします。

3. ログインが成功すると、"httpbin.org"のgetページにアクセスできます。"httpbin.org/get"ページは、X-Access-Token、X-Id-Token、およびX-Userinfoを含むリクエストデータを返します。

   ```
   "X-Access-Token": "******Y0RPcXRtc0FtWWVuX2JQaFo1ZVBvSlBNdlFHejN1dXY5elV3IiwiYWxnIjoiUlMyNTYifQ.***TVER3QUlPbWZYSVRzWHRxRWh2QUtQMWRzVDVGZHZnZzAiLCJpc3MiOiJodHRwczovL3FxdGVzdG1hbi5va3RhLmNvbSIsImF1ZCI6Imh0dHBzOi8vcXF0ZXN0bWFuLm9rdGEuY29tIiwic3ViIjoiMjgzMDE4Nzk5QHFxLmNvbSIsImlhdCI6MTYyODEyNjIyNSwiZXhwIjoxNjI4MTI5ODI1LCJjaWQiOiIwb2ExMWc4ZDg3TzBGQ0dYZzY5NiIsInVpZCI6IjAwdWEwNWVjZEZmV0tMS3VvNjk1Iiwic2NwIjpbIm9wZW5pZCIsInByb2Zpb***.****iBshIcJhy8QNvzAFD0fV4gh7OAdTXFMu5k0hk0JeIU6Tfg_Mh-josfap38nxRN5hSWAvWSk8VNxokWTf1qlaRbypJrKI4ntadl1PrvG-HgUSFD0JpyqSQcv10TzVeSgBfOVD-czprG2Azhck-SvcjCNDV-qc3P9KoPQz0SRFX0wuAHWUbj1FRBq79YnoJfjkJKUHz3uu7qpTK89mxco8iyuIwB8fAxPMoXjIuU6-6Bw8kfZ4S2FFg3GeFtN-vE9bE5vFbP-JFQuwFLZNgqI0XO2S7l7Moa4mWm51r2fmV7p7rdpoNXYNerXOeZIYysQwe2_L****",
   "X-Id-Token": "******aTdDRDJnczF5RnlXMUtPZUtuSUpQdyIsImFtciI6WyJwd2QiXSwic3ViIjoiMDB1YTA1ZWNkRmZXS0xLdW82OTUiLCJpc3MiOiJodHRwczpcL1wvcXF0ZXN0bWFuLm9rdGEuY29tIiwiYXVkIjoiMG9hMTFnOGQ4N08wRkNHWGc2OTYiLCJuYW1lIjoiUGV0ZXIgWmh1IiwianRpIjoiSUQuNGdvZWo4OGUyX2RuWUI1VmFMeUt2djNTdVJTQWhGNS0tM2l3Z0p5TTcxTSIsInZlciI6MSwicHJlZmVycmVkX3VzZXJuYW1lIjoiMjgzMDE4Nzk5QHFxLmNvbSIsImV4cCI6MTYyODEyOTgyNSwiaWRwIjoiMDBvYTA1OTFndHAzMDhFbm02OTUiLCJub25jZSI6ImY3MjhkZDMxMWRjNGY3MTI4YzlmNjViOGYzYjJkMDgyIiwiaWF0IjoxNjI4MTI2MjI1LCJhdXRoX3RpbWUi*****",
   "X-Userinfo": "*****lfbmFtZSI6IlpodSIsImxvY2FsZSI6ImVuLVVTIiwicHJlZmVycmVkX3VzZXJuYW1lIjoiMjgzMDE4Nzk5QHFxLmNvbSIsInVwZGF0ZWRfYXQiOjE2MjgwNzA1ODEsInpvbmVpbmZvIjoiQW1lcmljYVwvTG9zX0FuZ2VsZXMiLCJzdWIiOiIwMHVhMDVlY2RGZldLTEt1bzY5NSIsImdpdmVuX25hbWUiOiJQZXRlciIsIm5hbWUiOiJQZXRl****"
   ```

**X-Access-Token**: Apache APISIXは、ユーザープロバイダーから取得したアクセストークンをX-Access-Tokenリクエストヘッダーに含めます。オプションで、プラグイン設定のaccess\_token\_in\_authorization\_headerを使用してAuthorizationリクエストヘッダーに含めることもできます。

![X-Access-Token](https://static.api7.ai/2022/10/03/633a432f58583.png?imageMogr2/format/webp)

**X-Id-Token**: Apache APISIXは、ユーザープロバイダーから取得したIdトークンをBase64エンコードしてX-Id-Tokenリクエストヘッダーに含めます。この機能は、プラグイン設定のset\_id\_token\_headerを使用して有効にするかどうかを選択できます。デフォルトでは有効です。

![X-Id-Token](https://static.api7.ai/2022/10/03/633a432f4eb4f.png?imageMogr2/format/webp)

**X-Userinfo**: Apache APISIXは、ユーザープロバイダーから取得したユーザー情報をBase64エンコードしてX-Userinfoに含めます。この機能は、プラグイン設定のset\_userinfo\_headerを使用して有効にするかどうかを選択できます。デフォルトでは有効です。

![X-Userinfo](https://static.api7.ai/2022/10/03/633a432f150b4.png?imageMogr2/format/webp)

ご覧の通り、Apache APISIXはX-Access-Token、X-Id-Token、およびX-Userinfoリクエストヘッダーをアップストリームに送信します。アップストリームはこれらのヘッダーを解析して、ユーザーID情報やユーザーメタデータを取得できます。

Oktaから直接Apache APISIX Gatewayに集中型ID認証を構築するプロセスを示しました。無料のOkta Developer Accountに登録して始めるのは簡単です。このアプローチにより、開発者の負担を軽減し、安全で効率的な体験を実現できます。

## Oktaについて

Oktaは、アプリケーションに認証と認可サービスを追加するためのカスタマイズ可能で安全なドロップインソリューションです。開発のオーバーヘッド、セキュリティリスク、およびメンテナンスを伴わずに、アプリケーションにスケーラブルな認証を組み込むことができます。どのような言語やスタックのアプリケーションでもOktaに接続し、ユーザーのサインイン方法を定義できます。ユーザーが認証を試みるたびに、OktaはそのIDを確認し、必要な情報をアプリに返します。

## Apache APISIXについて

Apache APISIXは、動的でリアルタイムの高性能APIゲートウェイです。Apache APISIXは、ロードバランシング、動的アップストリーム、カナリアリリース、サーキットブレーカー、認証、可観測性などの豊富なトラフィック管理機能を提供します。Apache APISIXを使用して、従来の南北トラフィックだけでなく、サービス間の東西トラフィックも処理できます。また、k8s ingressコントローラーとしても使用できます。

世界中の数百の企業がApache APISIXを使用しており、金融、インターネット、製造、小売、通信事業者など、NASA、欧州連合のデジタルファクトリー、TravelSky、Tencent、Huawei、Weibo、中国移動、Taikang、360などが含まれます。

Github: <https://github.com/apache/apisix>

Website: [https://apisix.apache.org](https://apisix.apache.org/)

Tags:

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[Authentication & Authorization](https://api7.ai/tags/authentication-&-authorization)

[Plugin](https://api7.ai/tags/plugin)

Share article link

Share

Related Posts

[![Splunk HTTP Event Collector と Apache APISIX の統合](https://static.api7.ai/2022/11/18/6377314b77522.png)](https://api7.ai/blog/integrating-splunk-http-event-collector-with-apache-apisix)

## [Splunk HTTP Event Collector と Apache APISIX の統合](https://api7.ai/blog/integrating-splunk-http-event-collector-with-apache-apisix)

[![Forward-Auth、認証機能のもう一つの選択肢](https://static.api7.ai/2022/11/18/63772e00affaf.png)](https://api7.ai/blog/forward-auth-another-choice-for-authentication-function)

## [Forward-Auth、認証機能のもう一つの選択肢](https://api7.ai/blog/forward-auth-another-choice-for-authentication-function)

Table of Contents

- [前提条件](#%E5%89%8D%E6%8F%90%E6%9D%A1%E4%BB%B6)

- [ステップ1: Oktaの設定](#%E3%82%B9%E3%83%86%E3%83%83%E3%83%971-okta%E3%81%AE%E8%A8%AD%E5%AE%9A)

- [ステップ2: Apache APISIXのインストール](#%E3%82%B9%E3%83%86%E3%83%83%E3%83%972-apache-apisix%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB)

  - [依存関係のインストール](#%E4%BE%9D%E5%AD%98%E9%96%A2%E4%BF%82%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB)
  - [RPMパッケージによるインストール（CentOS 7）](#rpm%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AB%E3%82%88%E3%82%8B%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%ABcentos-7)
  - [Dockerによるインストール](#docker%E3%81%AB%E3%82%88%E3%82%8B%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB)
  - [Helm Chartによるインストール](#helm-chart%E3%81%AB%E3%82%88%E3%82%8B%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB)
  - [ソースリリースによるインストール](#%E3%82%BD%E3%83%BC%E3%82%B9%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%E3%81%AB%E3%82%88%E3%82%8B%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB)
  - [依存関係の初期化](#%E4%BE%9D%E5%AD%98%E9%96%A2%E4%BF%82%E3%81%AE%E5%88%9D%E6%9C%9F%E5%8C%96)

- [ステップ3: Apache APISIXを起動し、対応するルートを設定](#%E3%82%B9%E3%83%86%E3%83%83%E3%83%973-apache-apisix%E3%82%92%E8%B5%B7%E5%8B%95%E3%81%97%E5%AF%BE%E5%BF%9C%E3%81%99%E3%82%8B%E3%83%AB%E3%83%BC%E3%83%88%E3%82%92%E8%A8%AD%E5%AE%9A)

- [検証](#%E6%A4%9C%E8%A8%BC)

- [Oktaについて](#okta%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)

- [Apache APISIXについて](#apache-apisix%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)

## Related Posts

[![Apache APISIX 認証ポリシー：APIを保護する](https://static.api7.ai/uploads/2024/12/24/w5yfe0Nu_apisix-authorization-policy.png)](https://api7.ai/ja/blog/apisix-permission-policy)

Technology

April 21, 2023

#### [Apache APISIX 認証ポリシー：APIを保護する](https://api7.ai/ja/blog/apisix-permission-policy)

Apache APISIX の認可制御ポリシーは、API のセキュリティを保護し、システムが安全かつ安定して動作することを保証します。

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[Authentication & Authorization](https://api7.ai/tags/authentication-&-authorization)

[API Gateway Policy](https://api7.ai/tags/api-gateway-policy)

[![Amazon Lambdaを使用する際にApache APISIXが必要な理由](https://static.api7.ai/uploads/2024/12/25/PGShc0sm_apisix-aws-lambda.png)](https://api7.ai/ja/blog/why-do-you-need-apache-apisix-when-using-amazon-lambda)

Ecosystem

December 9, 2022

#### [Amazon Lambdaを使用する際にApache APISIXが必要な理由](https://api7.ai/ja/blog/why-do-you-need-apache-apisix-when-using-amazon-lambda)

クラウドネイティブのトレンドに合わせて、APISIXはserverless、azure-functions、openwhisk、openfunctionプラグインを提供することで、サーバーレスコンピューティングをサポートしています。

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[Amazon Lambda](https://api7.ai/tags/amazon-lambda)

[Plugin](https://api7.ai/tags/plugin)

[![Apache APISIXプラグインをゼロから作る方法は？](https://static.api7.ai/2022/11/18/63772ca27585f.png)](https://api7.ai/ja/blog/how-to-build-an-apache-apisix-plugin-from-0-to-1)

Ecosystem

February 16, 2022

#### [Apache APISIXプラグインをゼロから作る方法は？](https://api7.ai/ja/blog/how-to-build-an-apache-apisix-plugin-from-0-to-1)

過去数ヶ月の間に、コミュニティユーザーは多くのプラグインを追加しました...

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[Plugin](https://api7.ai/tags/plugin)
