Create SNI Associated to a Specific Certificate
POST {{gateway}}/certificates/:certificateNameOrId/snis
Create SNI Associated to a Specific Certificate 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.
| Attributes | Mandatory | Type | Description |
|---|
| certificate name or id | required | path | The unique identifier or the name attribute of the Certificate that should be associated to the newly-created SNI. |
Request Body
| Attributes | Mandatory | Type | Description |
|---|
| name | required | body | The SNI name to associate with the given certificate. |
| tags | optional | body | An optional set of strings associated with the SNIs, for grouping and filtering. |
| certificate | required | body | The 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"}}
| Key | Datatype | Required | Description |
|---|
Content-Type | string | | |