CORSサポートをAPIデプロイメントに追加

コンソールを使用してCORSリクエスト・ポリシーをAPIデプロイメント仕様に追加するには:

1. コンソールを使用してAPIデプロイメントを作成し、「最初から」オプションを選択して、「基本情報」ページで詳細を入力します。

   詳細は、APIデプロイメントの作成によるAPIゲートウェイへのAPIのデプロイおよびAPIゲートウェイの更新を参照してください。

2. 「基本情報」ページの「APIリクエスト・ポリシー」セクションで、CORS」の横の「追加」ボタンを選択し、次を指定します:

   • 許可されるオリジン: APIデプロイメントへのアクセスが許可されているオリジン。たとえば、https://oracle.comです。「+別のオリジン」を選択して、2番目以降のオリジンを入力します。
   • 許可されるメソッド: APIデプロイメントへの実際のリクエストで許可される1つ以上のメソッド。たとえば、GET, PUTです。
   • 許可されるヘッダー: オプションで、APIデプロイメントへの実際のリクエストで許可されるHTTPヘッダー。たとえば、opc-request-idまたはIf-Matchです。「+別のヘッダー」を選択し、2番目以降のヘッダーを入力します。
   • 公開ヘッダー: オプションで、APIクライアントが実際のリクエストに対するAPIデプロイメントのレスポンスでアクセスできるHTTPヘッダー。たとえば、ETagまたはopc-request-idです。「+別のヘッダー」を選択し、2番目以降のヘッダーを入力します。
   • 最大経過時間(秒): オプションで、プリフライト・リクエストの結果をブラウザでキャッシュできる期間(デルタ秒)を示す整数値。値を指定しない場合、デフォルトは0です。
   • 資格証明の許可の有効化: APIデプロイメントへの実際のリクエストを、資格証明(cookie、認可ヘッダーまたはTLSクライアント証明書)を使用して行えるかどうか。デフォルトでは、このオプションは選択されていません。

   CORSリクエスト・ポリシーの様々なフィールドを異なるCORSレスポンス・ヘッダーにマップする方法の詳細は、CORSリクエスト・ポリシーからCORSレスポンスへのマップ方法を参照してください。

3. 「変更の適用」を選択します。

4. 「次へ」を選択して、「認証」ページで認証オプションを指定します。

   認証オプションの詳細は、APIデプロイメントへの認証と認可の追加を参照してください。

5. 「次」を選択して、「ルート」ページのAPIデプロイメント内の個々のルートの詳細を入力します。個々のルートに適用するCORSリクエスト・ポリシーを指定するには、「リクエスト・ポリシーのルーティングを表示」を選択し、「CORS」の横にある「追加」ボタンを選択して、次を指定します:

   • 許可されるオリジン: ルートへのアクセスが許可されているオリジン。たとえば、https://oracle.comです。「+別のオリジン」を選択して、2番目以降のオリジンを入力します。
   • 許可されるメソッド: ルートへの実際のリクエストで許可される1つ以上のメソッド。たとえば、GET, PUTです。
   • 許可されるヘッダー: オプションで、ルートへの実際のリクエストで許可されているHTTPヘッダー。たとえば、opc-request-idまたはIf-Matchです。「+別のヘッダー」を選択し、2番目以降のヘッダーを入力します。
   • 公開ヘッダー: オプションで、APIクライアントが実際のリクエストに対するAPIデプロイメントのレスポンスでアクセスできるHTTPヘッダー。たとえば、ETagまたはopc-request-idです。「+別のヘッダー」を選択し、2番目以降のヘッダーを入力します。
   • 最大経過時間(秒): オプションで、プリフライト・リクエストの結果をブラウザでキャッシュできる期間(デルタ秒)を示す整数値。値を指定しない場合、デフォルトは0です。
   • 資格証明の許可の有効化: ルートへの実際のリクエストを、資格証明(cookie、認可ヘッダーまたはTLSクライアント証明書)を使用して行えるかどうか。デフォルトでは、このオプションは選択されていません。

   CORSリクエスト・ポリシーの様々なフィールドを異なるCORSレスポンス・ヘッダーにマップする方法の詳細は、CORSリクエスト・ポリシーからCORSレスポンスへのマップ方法を参照してください。

6. 「変更の適用」を選択し、「次」を選択して、APIデプロイメントおよび個々のルートに入力した詳細を確認します。
7. APIデプロイメントを作成または更新するには、「作成」または「変更の保存」を選択します。
8. (オプション) コールしてAPIが正常にデプロイされていることを確認します(APIゲートウェイにデプロイされたAPIのコールを参照)。

CORSリクエスト・ポリシーをJSONファイル内のAPIデプロイメント仕様に追加するには:

1. 任意のJSONエディタを使用して、CORSサポートを追加する既存のAPIデプロイメント仕様を編集するか、新しいAPIデプロイメント仕様を作成します(APIデプロイメント仕様の作成を参照)。

   たとえば、次の基本的なAPIデプロイメント仕様では、OCI Functionsの単純なHello Worldサーバーレス・ファンクションを単一のバック・エンドとして定義しています:

   {
     "routes": [
       {
         "path": "/hello",
         "methods": ["GET"],
         "backend": {
           "type": "ORACLE_FUNCTIONS_BACKEND",
           "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
         }
       }
     ]
   }

2. APIデプロイメント内のすべてのルートにグローバルに適用するCORSリクエスト・ポリシーを指定するには:

   1. routesセクションの前にrequestPoliciesセクションを挿入します(まだ存在しない場合)。例:

      {
        "requestPolicies": {},
        "routes": [
          {
            "path": "/hello",
            "methods": ["GET"],
            "backend": {
              "type": "ORACLE_FUNCTIONS_BACKEND",
              "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
            }
          }
        ]
      }

   2. 次のcorsポリシーを新しいrequestPoliciesセクションに追加して、APIデプロイメント内のすべてのルートにグローバルに適用します:

      {
        "requestPolicies": {
          "cors":{
            "allowedOrigins": [<list-of-origins>],
            "allowedMethods": [<list-of-methods>],
            "allowedHeaders": [<list-of-implicit-headers>],
            "exposedHeaders": [<list-of-exposed-headers>],
            "isAllowCredentialsEnabled": <true|false>,
            "maxAgeInSeconds": <seconds>
          }
        },
        "routes": [
          {
            "path": "/hello",
            "methods": ["GET"],
            "backend": {
              "type": "ORACLE_FUNCTIONS_BACKEND",
              "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
            }
          }
        ]
      }

      ここでは:

      • "allowedOrigins": [<list-of-origins>]は、APIデプロイメントへのアクセスが許可されているオリジンの必須のカンマ区切りリストです。たとえば、, "allowedOrigins": ["*", "https://oracle.com"]です
      • "allowedMethods": [<list-of-methods>]は、APIデプロイメントへの実際のリクエストで許可されるHTTPメソッドのオプションのカンマ区切りリストです。たとえば、"allowedMethods": ["*", "GET"]です
      • "allowedHeaders": [<list-of-implicit-headers>]は、APIデプロイメントへの実際のリクエストで許可されるHTTPヘッダーのオプションのカンマ区切りリストです。たとえば、"allowedHeaders": ["opc-request-id", "If-Match"]です
      • "exposedHeaders": [<list-of-exposed-headers>]は、実際のリクエストに対するAPIデプロイメントのレスポンスでAPIクライアントがアクセスできる、HTTPヘッダーのオプションのカンマ区切りリストです。たとえば、"exposedHeaders": ["ETag", "opc-request-id"]です
      • "isAllowCredentialsEnabled": <true|false>は、資格証明(cookie、認可ヘッダーまたはTLSクライアント証明書)を使用してAPIデプロイメントへの実際のリクエストを行うことができるかどうかを示すtrueまたはfalseです。指定しない場合、デフォルトはfalseです。
      • "maxAgeInSeconds": <seconds>は、プリフライト・リクエストの結果をブラウザでキャッシュできる期間(デルタ秒)を示す整数値です。指定しない場合、デフォルトは0です。

      例:

      {
        "requestPolicies": {
          "cors":{
            "allowedOrigins": ["*", "https://oracle.com"],
            "allowedMethods": ["*", "GET"],
            "allowedHeaders": [],
            "exposedHeaders": [],
            "isAllowCredentialsEnabled": false,
            "maxAgeInSeconds": 3000
          }
        },
        "routes": [
          {
            "path": "/hello",
            "methods": ["GET"],
            "backend": {
              "type": "ORACLE_FUNCTIONS_BACKEND",
              "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
            }
          }
        ]
      }

      CORSリクエスト・ポリシーの様々なフィールドを異なるCORSレスポンス・ヘッダーにマップする方法の詳細は、CORSリクエスト・ポリシーからCORSレスポンスへのマップ方法を参照してください。

3. 個々のルートに適用するCORSリクエスト・ポリシーを指定するには:

   1. ポリシーを適用するルートのバックエンド・セクションの後にrequestPoliciesセクションを挿入します。例:

      {
        "routes": [
          {
            "path": "/hello",
            "methods": ["GET"],
            "backend": {
              "type": "ORACLE_FUNCTIONS_BACKEND",
              "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
            },
            "requestPolicies": {}
          }
        ]
      }

   2. 次のcorsポリシーを新しいrequestPoliciesセクションに追加して、この特定のルートのみに適用します:

      {
        "routes": [
          {
            "path": "/hello",
            "methods": ["GET"],
            "backend": {
              "type": "ORACLE_FUNCTIONS_BACKEND",
              "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
            },
            "requestPolicies": {
              "cors":{
                 "allowedOrigins": [<list-of-origins>],
                 "allowedMethods": [<list-of-methods>],
                 "allowedHeaders": [<list-of-implicit-headers>],
                 "exposedHeaders": [<list-of-exposed-headers>],
                 "isAllowCredentialsEnabled": <true|false>,
                 "maxAgeInSeconds": <seconds>
              }
            }
          }
        ]
      }

      ここでは:

      • "allowedOrigins": [<list-of-origins>]は、APIデプロイメントへのアクセスが許可されているオリジンの必須のカンマ区切りリストです。たとえば、, "allowedOrigins": ["*", "https://oracle.com"]です
      • "allowedMethods": [<list-of-methods>]は、APIデプロイメントへの実際のリクエストで許可されるHTTPメソッドのオプションのカンマ区切りリストです。たとえば、"allowedMethods": ["*", "GET"]です
      • "allowedHeaders": [<list-of-implicit-headers>]は、APIデプロイメントへの実際のリクエストで許可されるHTTPヘッダーのオプションのカンマ区切りリストです。たとえば、"allowedHeaders": ["opc-request-id", "If-Match"]です
      • "exposedHeaders": [<list-of-exposed-headers>]は、実際のリクエストに対するAPIデプロイメントのレスポンスでAPIクライアントがアクセスできる、HTTPヘッダーのオプションのカンマ区切りリストです。たとえば、"exposedHeaders": ["ETag", "opc-request-id"]です
      • "isAllowCredentialsEnabled": <true|false>は、資格証明(cookie、認可ヘッダーまたはTLSクライアント証明書)を使用してAPIデプロイメントへの実際のリクエストを行うことができるかどうかを示すtrueまたはfalseです。指定しない場合、デフォルトはfalseです。
      • "maxAgeInSeconds": <seconds>は、プリフライト・リクエストの結果をブラウザでキャッシュできる期間(デルタ秒)を示す整数値です。指定しない場合、デフォルトは0です。

      例:

      {
        "routes": [
          {
            "path": "/hello",
            "methods": ["GET"],
            "backend": {
              "type": "ORACLE_FUNCTIONS_BACKEND",
              "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
            },
            "requestPolicies": {
              "cors":{
                 "allowedOrigins": ["*", "https://oracle.com"],
                 "allowedMethods": ["*", "GET"],
                 "allowedHeaders": [],
                 "exposedHeaders": [],
                 "isAllowCredentialsEnabled": false,
                 "maxAgeInSeconds": 3000
              }
            }
          }
        ]
      }

      CORSリクエスト・ポリシーの様々なフィールドを異なるCORSレスポンス・ヘッダーにマップする方法の詳細は、CORSリクエスト・ポリシーからCORSレスポンスへのマップ方法を参照してください。

4. APIデプロイメント仕様を含むJSONファイルを保存します。

5. APIデプロイメント仕様は、次の方法でAPIデプロイメントを作成または更新するときに使用します:

   • JSONファイルをコンソールで「既存のAPIのアップロード」オプションで指定します
   • APIゲートウェイREST APIへのリクエストでJSONファイルを指定します

   詳細は、APIデプロイメントの作成によるAPIゲートウェイへのAPIのデプロイおよびAPIゲートウェイの更新を参照してください。

6. (オプション) コールしてAPIが正常にデプロイされていることを確認します(APIゲートウェイにデプロイされたAPIのコールを参照)。

次の表に示すように、CORSリクエスト・ポリシーの様々なフィールドを異なるCORSレスポンス・ヘッダーにマップします: