x-amazon-apigateway-integration. tlsConfig oggetto - Amazon API Gateway
x-amazon-apigateway-integration. tlsConfig esempi

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à.

x-amazon-apigateway-integration. tlsConfig oggetto

Specifica la TLS configurazione per un'integrazione.

Nome proprietà Tipo Descrizione
insecureSkipVerification Boolean

Supportato solo per RESTAPIs. Speciifica 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 certificato, del nome host e della presenza di un'autorità di certificazione principale. 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 insecureSkipVerification non è consigliata, in particolare per le integrazioni con endpoint pubblici. HTTPS Se abilitiinsecureSkipVerification, aumenti il rischio di man-in-the-middle attacchi.
serverNameToVerify string

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

x-amazon-apigateway-integration. tlsConfig esempi

Il seguente esempio di Open API 3.0 abilita insecureSkipVerification l'integrazione REST API HTTP del proxy.

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

Il seguente esempio di Open API 3.0 specifica una serverNameToVerify per un'integrazione HTTP API privata.

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