Create SNI

POST {{gateway}}/snis

Create SNI konghq

  • An SNI object represents a many-to-one mapping of hostnames to a certificate. That is, a certificate object can have many hostnames associated with it; when Kong receives an SSL request, it uses the SNI field in the Client Hello to lookup the certificate object based on the SNI associated with the certificate.
  • SNIs can be both tagged and filtered by tags.

Request Body

AttributesMandatoryTypeDescription
namerequiredbodyThe SNI name to associate with the given certificate.
tagsoptionalbodyAn optional set of strings associated with the SNIs, for grouping and filtering.
certificaterequiredbodyThe id (a UUID) of the certificate with which to associate the SNI hostname. The Certificate must have a valid private key associated with it to be used by the SNI object. With form-encoded, the notation is certificate.id=. With JSON, use “"certificate":{"id":""}.

Request Body

{"name"=>"my-sni", "tags"=>["user-level", "low-priority"], "certificate"=>{"id"=>"a2e013e8-7623-4494-a347-6d29108ff68b"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: Created

{"id":"91020192-062d-416f-a275-9addeeaffaf2","name":"my-sni","created_at":1422386534,"tags":["user-level","low-priority"],"certificate":{"id":"a2e013e8-7623-4494-a347-6d29108ff68b"}}