HTTP Hosting Endpoint Certificate Configuration
Secure an HTTP endpoint with an SSL X.509 certificate.
Configuration Path
Section titled “Configuration Path”HAKOM:TSM:Http:Hosting:Endpoints:{EndpointName}:CertificateConfiguration Structure
Section titled “Configuration Structure”Two types are supported:
For .pfx X.509 certificate files:
Certificate├─ Path└─ PasswordFor installed X.509 certificates in a certificate store:
Certificate├─ Location├─ Store├─ Subject└─ AllowInvalidConfiguration Elements
Section titled “Configuration Elements”.pfx X.509 Certificate Files
Section titled “.pfx X.509 Certificate Files”Specify the path (Path) of the locally stored certificate file. If the certificate file is encrypted, also specify the corresponding password in the Password element.
| Element | Type | Default | Required | Description |
|---|---|---|---|---|
Path |
string |
— | ✓ | The path to the certificate file on the local file system. |
Password |
string |
— | The password needed to decrypt the certificate file if it is encrypted. |
Non-encrypted local X.509 certificate file
Section titled “ Non-encrypted local X.509 certificate file”Use an X.509 certificate stored in C:\my_certificate.pfx:
<Certificate> <Path>C:\my_certificate.pfx</Path></Certificate>Encrypted local X.509 certificate file
Section titled “ Encrypted local X.509 certificate file”Use an X.509 certificate stored in C:\my_certificate.pfx. The certificate is encrypted with the password mypwd:
<Certificate> <Path>C:\my_certificate.pfx</Path> <Password>mypwd</Password></Certificate>Installed X.509 Certificates in a Certificate Store
Section titled “Installed X.509 Certificates in a Certificate Store”Certificates from a certificate store are also supported. Specify the following elements to use an installed certificate from a certificate store.
| Element | Type | Default | Required | Description |
|---|---|---|---|---|
Location |
enum |
— | The Windows certificate store location to search (see below). | |
Store |
enum |
— | The specific store within the selected certificate store location to search (see below). | |
Subject |
string |
— | The subject of the certificate. | |
AllowInvalid |
bool |
false |
Whether to allow invalid certificates to be used. Only use this for testing! |
Location may have one of the following values:
| Location | Description |
|---|---|
CurrentUser |
The current user’s certificate store. |
LocalMachine |
The local machine’s certificate store. |
Store may have one of the following values:
| Store | Description |
|---|---|
AddressBook |
Look for the certificate in the X.509 certificate store for other users. |
AuthRoot |
Look for the certificate in the X.509 certificate store for third-party certificate authorities (CAs). |
CertificateAuthority |
Look for the certificate in the X.509 certificate store for intermediate certificate authorities (CAs). |
Disallowed |
Look for the certificate in the X.509 certificate store for revoked certificates. |
My |
Look for the certificate in the X.509 certificate store for personal certificates. |
Root |
Look for the certificate in the X.509 certificate store for trusted root certificate authorities (CAs). |
TrustedPeople |
Look for the certificate in the X.509 certificate store for directly trusted people and resources. |
TrustedPublisher |
Look for the certificate in the X.509 certificate store for directly trusted publishers. |
Use an installed certificate from the current user’s personal store
Section titled “ Use an installed certificate from the current user’s personal store”Use a locally installed X.509 certificate called TestABC of the current user’s personal Windows certificate store:
<Certificate> <Location>CurrentUser</Location> <Store>My</Store> <Subject>TestABC</Subject></Certificate>Use an installed dev/test/self-signed certificate from the current user’s personal store
Section titled “ Use an installed dev/test/self-signed certificate from the current user’s personal store”Use a locally installed self-signed X.509 test certificate called TestABC of the current user’s personal Windows certificate store to run a development-service:
<Certificate> <Location>CurrentUser</Location> <Store>My</Store> <Subject>TestABC</Subject> <AllowInvalid>true</AllowInvalid></Certificate>