How to configure HTTPS endpoints in WebAPI services

Search…
There are three areas that need to be modified.
(this assumes you use the standard service template code)
Service Manifest
Define the Protocol to be https. You also might want to change the port as well. I have set it to the security default of 443.
1
  <Resources>
2
    <Endpoints>
3
      <Endpoint Protocol="https" Name="ServiceEndpoint" Type="Input" Port="443" />
4
    </Endpoints>
5
  </Resources>
6
</ServiceManifest>
Copied!
Application Manifest
In the ApplicationManifest xml, the certificate needs to be referenced in the <Certificates> section at the bottom.
IMPORTANT NOTE: When replacing the cert thumbnail for the X509FindValue take extra care when copying it from the MMC Certificates properties window. You will most likely include a hidden character at the start of the thumbnail.
Next ensure in the <Policies> section, you mention which certificate is linked to which service.
Ensure the EndPointRef matches up with the Endpoint name in the ServiceManifest.xml
1
  <ServiceManifestImport>
2
    <ServiceManifestRef ServiceManifestName="TestServicePkg" ServiceManifestVersion="1.0.0" />
3
    <ConfigOverrides />
4
    <Policies>
5
      <EndpointBindingPolicy CertificateRef="TestServiceCert" EndpointRef="ServiceEndpoint"/>
6
    </Policies>
7
  </ServiceManifestImport>
8
  <DefaultServices>
9
    <Service Name="TestService">
10
      <StatelessService ServiceTypeName="TestServiceType" InstanceCount="[TestService_InstanceCount]">
11
        <SingletonPartition />
12
      </StatelessService>
13
    </Service>
14
  </DefaultServices>
15
  <Certificates>
16
    <EndpointCertificate Name="TestServiceCert" X509FindValue="FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F0" X509StoreName="MY" />
17
  </Certificates>
18
</ApplicationManifest>
Copied!
So far, this matches us with the instructions Microsoft have documented here, but it seems one additional step is required..
Update OwinCommunicationListener.cs
If you are using the WebAPI Service Template, a OwinCommunicationListener.cs file is generated. This is useful but it is hard coded to be http.
The OpenAsync method should be updated to the following:
1
public Task<string> OpenAsync(CancellationToken cancellationToken)
2
{
3
    var serviceEndpoint = this.serviceContext.CodePackageActivationContext.GetEndpoint(this.endpointName);
4
    int port = serviceEndpoint.Port;
5
    var protocol = serviceEndpoint.Protocol; // <- UPDATED
6
​
7
    if (this.serviceContext is StatefulServiceContext)
8
    {
9
        StatefulServiceContext statefulServiceContext = this.serviceContext as StatefulServiceContext;
10
​
11
        this.listeningAddress = string.Format(
12
            CultureInfo.InvariantCulture,
13
            "{0}://+:{1}/{2}{3}/{4}/{5}", // <- UPDATED
14
            protocol,                     // <- UPDATED
15
            port,
16
            string.IsNullOrWhiteSpace(this.appRoot)
17
                ? string.Empty
18
                : this.appRoot.TrimEnd('/') + '/',
19
            statefulServiceContext.PartitionId,
20
            statefulServiceContext.ReplicaId,
21
            Guid.NewGuid());
22
    }
23
    else if (this.serviceContext is StatelessServiceContext)
24
    {
25
​
26
        this.listeningAddress = string.Format(
27
            CultureInfo.InvariantCulture,
28
            "{0}://+:{1}/{2}",      // <- UPDATED
29
            protocol,               // <- UPDATED
30
            port,
31
            string.IsNullOrWhiteSpace(this.appRoot)
32
                ? string.Empty
33
                : this.appRoot.TrimEnd('/') + '/');
34
    }
35
    else
36
    {
37
        throw new InvalidOperationException();
38
    }
Copied!
Now when your service is deployed, the https endpoint should work as expected.
Working with Service Fabric stateless WebAPI services
Where to find stand alone packages for Service Fabric
Last modified 2yr ago
Copy link
Contents
Service Manifest
Application Manifest
Update OwinCommunicationListener.cs