---
schema_version: "1"
id: 3ef61c3ceab25fd326bcd56b51c602d5643fde89dc4022669ee76aa283ddfd06
title: Flex Gateway の使用開始
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/gateway/1.8/flex-gateway-getting-started.md
canonical_url: https://docs.mulesoft.com/jp/gateway/1.8/flex-gateway-getting-started
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 204ebbd8f39f324d45a214dc085b8fc10c7582163b0698d1ded86404b74005fa
description: MuleSoft Documentation Site
release: "1.8"
latest: false
---
# Flex Gateway の使用開始

このチュートリアルの目標は、Anypoint Flex Gateway をすばやく使い始めることです。このチュートリアルでは、Docker を使用して、接続モードで Flex Gateway をインストール、登録、実行する方法について説明します。さらに、基本認証ポリシーで保護された API をパブリッシュする方法についても説明します。

## [](#始める前に)始める前に

Flex Gateway の使用を始める前に、次の準備が整っていることを確認します。

- 自分の Anypoint Platform 組織のユーザー名とパスワード。まだ Anypoint Platform 組織を持っていない場合は、Anypoint Platform で [トライアル組織を作成](https://anypoint.mulesoft.com/login/signup)​してください。
- x86 プロセッサーを搭載した Linux マシン。M1 および M2 プロセッサーはサポートされていません。
    
    Flex Gateway は、以下の Long Term Support (LTS) バージョンの Linux で動作します。
    
    - Amazon Linux 2023
    - CentOS 8
    - Debian (Bullseye, Bookworm)
    - Red Hat Enterprise Linux (9)
    - IBM Power (ppc64le) の Red Hat Enterprise Linux (9)
    - SUSE Linux Enterprise (SLES 15 SP3)
    - IBM Power (ppc64le) の SUSE Linux Enterprise (SLES 15 SP3)
    - Ubuntu (Focal, Jammy)
- Docker のインストール。例については [「Docker Desktop」](https://www.docker.com/products/docker-desktop/)​を参照してください。

## [](#flex-gateway-のダウンロード)Flex Gateway のダウンロード

Flex Gateway Docker イメージをダウンロードするには、ターミナルウィンドウで次のコマンドを実行します。

```ssh
docker pull mulesoft/flex-gateway:1.8.0
```

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このコマンドの実行時にファイル権限の問題が発生した場合は、​<code>sudo</code>​ を使用してください。</td></tr></tbody></table>

## [](#flex-gateway-を登録する)Flex Gateway を登録する

1. 次のコマンドを実行して、新しいディレクトリを作成します。
    
    ```ssh
    mkdir flex-registration
    ```
2. 次のコマンドを実行して、新しいディレクトリに移動します。
    
    ```ssh
    cd flex-registration
    ```
3. Anypoint ユーザー名とパスワードを使用して、 [Anypoint Platform](https://anypoint.mulesoft.com/login/)​ にログインします。
4. **\[Runtime Manager\]**​ を選択します。
5. サイドナビゲーションパネルで,**\[Flex Gateways\]**​ タブをクリックします。
6. **\[Add Gateway (ゲートウェイを追加)\]**​ をクリックします。
7. **\[Docker\]**​ を選択します。
8. **\[Register your gateway (ゲートウェイを登録)\]**​ セクションのコードブロックをコピーします。コードブロックには、一意の組織 ID とトークンが含まれています。
    
    次の ​**\[Add a Flex Gateway (Flex Gateway の追加)\]**​ ページのスクリーンショットでは、コピーするコードブロックが強調表示されています。
    
    ![コピーするコードブロックが選択されている \[Add a Flex Gateway (Flex Gateway の追加)\] ページ](_images/gateway-quickstart-add-gateway.png)
9. コピーしたコードブロックをターミナルウィンドウで実行します。最初に ​`<gateway-name>`​ を ​`my-gw`​ などの名前に置き換えてください。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このコマンドの実行時にファイル権限の問題が発生した場合は、​<code>sudo</code>​ を使用してください。</td></tr></tbody></table>
10. Runtime Manager のサイドバーナビゲーションで ​**\[Flex Gateways\]**​ を選択します。
    
    登録した Flex Gateway がゲートウェイのリストに表示されます。

## [](#flex-gateway-を実行する)Flex Gateway を実行する

Flex Gateway を実行するには、ターミナルウィンドウで次のコマンドを実行します。

```ssh
docker run --rm \
  -v "$(pwd)":/usr/local/share/mulesoft/flex-gateway/conf.d \
  -p 8081:8081 \
  mulesoft/flex-gateway
```

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このコマンドの実行時にファイル権限の問題が発生した場合は、​<code>sudo</code>​ を使用してください。</td></tr></tbody></table>

新しい Flex Gateway インスタンスがターミナルウィンドウで実行されます。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">Flex Gateway インスタンスは、プロセスが停止されるかウィンドウが閉じられるまで、ターミナルウィンドウで実行を続けます。</td></tr></tbody></table>

## [](#シンプルな-api-のパブリッシュ)シンプルな API のパブリッシュ

1. Anypoint Platform メニューから ​**\[API Manager\]**​ を選択します。
2. **\[Add API (API を追加)\]**​ をクリックし、​**\[Add new API (新しい API を追加)\]**​ をクリックします:
    
    ![\[Add new API (新しい API を追加)\] が選択されている \[Add API (API を追加)\] ページ](_images/gateway-quickstart-add-new-api.png)
3. **\[Add API (API を追加)\]**​ ページから、ランタイムとして ​**\[Flex Gateway\]**​ を選択します。
4. **\[Select a gateway (ゲートウェイを選択)\]**​ セクションで登録済みゲートウェイを選択します。
5. **\[Next (次へ)\]**​ をクリックします。
    
    次の ​**\[Add API (API を追加)\]**​ ページのスクリーンショットでは、指定されたオプションが強調表示されています。
    
    ![Flex Gateway ランタイムと my-gw ゲートウェイが選択されている \[Add API (API を追加)\]](_images/gateway-quickstart-select-gateway-for-api.png)
6. **\[Create New API (新しい API を作成)\]**​ をクリックします。
7. API 参照名を指定し、アセットタイプとして ​**\[HTTP API\]**​ を選択します。
8. **\[次へ\]**​ をクリックします。
9. **\[Endpoint (エンドポイント)\]**​ ページから、​**\[Implementation URI (実装 URI)\]**​ 項目に次の URI を入力します。
    
    ```none
    https://jsonplaceholder.typicode.com/
    ```
10. **\[Port (ポート)\]**​ 項目に「​`8081`​」と入力します。
11. **\[次へ\]**​ をクリックします。
12. **\[Save & Deploy (保存してデプロイ)\]**​ をクリックします。
    
    ゲートウェイインスタンスの Docker コンテナ内で、ポート ​`8081`​ の ​`localhost`​ に対して行われたすべての HTTP 要求が ​`jsonplaceholder`​ サービスにプロキシされるようになります。
13. API インスタンスをテストするには、新しいターミナルウィンドウで次のコマンドを実行します。
    
    ```ssh
    curl -s -o /dev/null -w "%{http_code}\n" --request GET 'http://localhost:8081/'
    ```
    
    このコマンドは API への ​`GET`​ 要求を実行し、結果として成功を示す ​`200`​ 状況コードを出力します。

## [](#基本認証ポリシーを使用して-api-を保護する)基本認証ポリシーを使用して API を保護する

1. **API Manager**​ を開いたまま、サイドナビゲーションパネルから ​**\[API Administration (API 管理)\]**​ を選択します。
2. 前のセクションで作成した API の名前を選択します。
3. サイドナビゲーションパネルから ​**\[Policies (ポリシー)\]**​ を選択します。
4. **\[Policies (ポリシー)\]**​ ページで、​**\[Add policy (ポリシーを追加)\]**​ をクリックします。
    
    次の ​**\[Policies (ポリシー)\]**​ ページのスクリーンショットでは、指定されたオプションが強調表示されています。
    
    ![\[Add policy (ポリシーを追加)\] ボタンのある \[Add policy (ポリシーを追加)\] ページ](_images/gateway-quickstart-add-policy.png)
5. **\[Basic Authentication - Simple (基本認証 - シンプル)\]**​ ポリシーを選択します。
6. **\[Next (次へ)\]**​ をクリックします。
7. **\[User Name (ユーザー名)\]**​ に「​`user`​」と入力します。
8. **\[User Password (ユーザーパスワード)\]**​ に「​`password`​」と入力します。
9. **\[Apply (適用)\]**​ をクリックします。
    
    次の ​**\[Basic Authentication - Simple policy (基本認証 - 簡易ポリシー)\]**​ ページのスクリーンショットでは、指定されたオプションが強調表示されています。
    
    ![\[User Password (ユーザーパスワード)\] 項目が選択されている \[Configure Basic Authentication - Simple policy (基本認証 - 簡易ポリシーを設定)\] ページ](_images/gateway-quickstart-config-basic-auth.png)
10. 認証を​_使用しないで_​ API インスタンスをテストするには、ターミナルウィンドウで次の ​`curl`​ コマンドを実行します。
    
    ```ssh
    curl -s -o /dev/null -w "%{http_code}\n" --request GET 'http://localhost:8081/'
    ```
    
    要求には認証コンテキストが含まれていないため、コマンドは結果として ​`401 (Unauthorized)`​ 状況コードを出力します。
11. 認証を​_使用して_​ API インスタンスをテストするには、ターミナルウィンドウで次のコマンドを実行します。
    
    ```ssh
    curl -s -o /dev/null -w "%{http_code}\n" --request GET 'http://localhost:8081/' -u user:password
    ```
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content"><code>user</code>​ パラメーターと ​<code>password</code>​ パラメーターは、​<strong>API Manager</strong>​ 経由でポリシーを適用したときに指定した内容と一致する必要があります。</td></tr></tbody></table>
    
    このコマンドは、結果として成功を示す ​`200`​ 状況コードを出力します。

## [](#次のステップ)次のステップ

- [Flex Gateway の要件と制限](https://docs.mulesoft.com/jp/gateway/1.8/flex-review-prerequisites)
- [Flex Gateway のセットアップ](https://docs.mulesoft.com/jp/gateway/1.8/flex-gateway-set-up)