

# x-amazon-apigateway-integration.tlsConfig オブジェクト
<a name="api-gateway-extensions-integration-tls-config"></a>

統合の TLS 設定を指定します。


| プロパティ名 | タイプ | 説明 | 
| --- | --- | --- | 
| insecureSkipVerification | Boolean | REST API でのみサポートされます。[サポートされている認証機関](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-supported-certificate-authorities-for-http-endpoints.html)から統合エンドポイントの証明書が発行されているかどうかの検証を API Gateway がスキップするかどうかを指定します。これはお勧めしませんが、プライベート認証機関によって署名された証明書、または自己署名された証明書を使用できます。有効にした場合でも、API Gateway は証明書の基本的な検証を実行します。これには、証明書の有効期限、ホスト名、ルート認証機関の存在の確認が含まれます。民間機関に属するルート証明書は、以下の制約を満たす必要があります。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/apigateway/latest/developerguide/api-gateway-extensions-integration-tls-config.html)<br /> `HTTP` および `HTTP_PROXY` 統合でのみサポートされます。 `insecureSkipVerification` の有効化は、特にパブリック HTTPS エンドポイントとの統合には推奨されません。`insecureSkipVerification` を有効にすると、中間者 (MITM) 攻撃のリスクが高くなります。  | 
| serverNameToVerify | string | HTTP API プライベート統合でのみサポートされます。サーバー名を指定すると、API Gateway ではそれを使用して統合の証明書のホスト名を検証します。サーバー名は、Server Name Indication (SNI) または仮想ホスティングをサポートするために、TLS ハンドシェイクにも含まれています。 | 

## x-amazon-apigateway-integration.tlsConfig examples
<a name="api-gateway-extensions-integration-tls-config-example"></a>

以下の OpenAPI3.0 の例では、REST API HTTP プロキシ統合に対して `insecureSkipVerification` を有効にしています。

```
"x-amazon-apigateway-integration": {
  "uri": "http://petstore-demo-endpoint.execute-api.com/petstore/pets",
  "responses": {
     default": {
       "statusCode": "200"
      }
  },
  "passthroughBehavior": "when_no_match",
  "httpMethod": "ANY",
  "tlsConfig" : {
    "insecureSkipVerification" : true
  }
  "type": "http_proxy",
}
```

以下の OpenAPI 3.0 の例では、REST API プライベート統合に対して `serverNameToVerify` を指定しています。

```
"x-amazon-apigateway-integration" : {
  "payloadFormatVersion" : "1.0",
  "connectionId" : "abc123",
  "type" : "http_proxy",
  "httpMethod" : "ANY",
  "uri" : "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65",
  "connectionType" : "VPC_LINK",
  "tlsConfig" : {
     "serverNameToVerify" : "example.com"
  }
}
```