View a markdown version of this page

Oggetto x-amazon-apigateway-integration.tlsConfig - Gateway Amazon API
Esempi di x-amazon-apigateway-integration.tlsConfig

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Oggetto x-amazon-apigateway-integration.tlsConfig

Specifica la configurazione TLS per un'integrazione.

Nome proprietà Tipo Descrizione
insecureSkipVerification Boolean

Supportato solo per API REST. Specifica se API Gateway ignora o meno la verifica che il certificato per un endpoint di integrazione sia emesso da un'autorità di certificazione supportata. Questa operazione non è consigliata, ma consente di utilizzare certificati firmati da autorità di certificazione private o certificati autofirmati. Se abilitato, API Gateway esegue comunque la convalida di base del certificato, che include il controllo della data di scadenza, del nome host, della presenza di un'autorità di certificazione principale e dell'integrità della catena di certificati. La convalida della catena di certificati include l'applicazione dei vincoli di nome X509v3. Se riscontri errori di convalida con l'insecureSkipVerificationopzione abilitata, verifica che i certificati CA non includano le estensioni Name Constraints o riemettili senza tale estensione. Il certificato radice appartenente all'autorità privata deve soddisfare i seguenti vincoli:

  • L'estensione x509 keyUsage deve avere keyCertSign.

  • L'estensione x509 basicConstraints deve avere CA:TRUE.

Supportato solo per integrazioni HTTP e HTTP_PROXY.

avvertimento

L'abilitazione di insecureSkipVerification non è consigliata, soprattutto per le integrazioni con endpoint HTTPS pubblici. Se abiliti insecureSkipVerification, aumenti il rischio di attacchi man in the middle.
serverNameToVerify string

Supportato solo per le integrazioni private API HTTP. Se si specifica un nome server, API Gateway lo utilizza per verificare il nome host sul certificato dell'integrazione. Il nome del server è incluso anche nell'handshake TLS per supportare SNI (Server Name Indication) o l'hosting virtuale.

Esempi di x-amazon-apigateway-integration.tlsConfig

L'esempio seguente di OpenAPI 3.0 abilita insecureSkipVerification per un'integrazione del proxy HTTP API REST.

"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",
}

L'esempio seguente di OpenAPI 3.0 specifica un serverNameToVerify per un'integrazione privata API HTTP.

"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"
  }
}