Share via


Changing my Workflow Manager Farm Certificates

From my experience one of the situation that most scares anyone administering a WFM Farm is changing/update the certificates.

In fact, there is no reason for that fear because the process is pretty much straightforward.

See how easy it is.

So, the first step should be updating the Service Bus Services, for that you should start a Workflow Manager PowerShell console as an Administrator and run the below cmdlets. Set-SBCertificate -FarmCertificateThumbprint YourThumbprint   -EncryptionCertificateThumbprint YourThumbprint Stop-SBFarm -VerboseUpdate-SBHostStart-SBFarm

After this step, we need to update the Workflow Manager Services related Certificates

Set-WFCertificate -SslCertificateThumbprint YourThumbprint -EncryptionCertificateThumbprint YourThumbprintStop-WFHostUpdate-WFHostStart-WFHost

If everything went well, this easy steps should do the trick, but as we all known that is not always the case.

So, as the next step we should check the WFM Outbound Certificate, since there is where we see the most issues. For that, you can follow the this process.

Fist run the below cmdlet
Get-WFOutboundCertificate -ServiceURI https://nameofyourserver:12290/

If still returns the old one, do the following:

Set-WFNextOutboundCertificateReference -ServiceURI https://nameofyourserver:12290/ -Thumbprint yourThumbprint

Now if you run the Get-WFOutboundCertificate cmdlet you should get the old one and the new one.
2outboundcerts

Now run the following the cmdlet to define the new one as the default for the current workflow manager farm

Set-WFNextOutboundCertificateAsCurrent -ServiceURI https://nameofyourserver:12290/

Now if you run the Get-WFOutboundCertificate Cmdlet again, you should get the just the new one

Get-WFOutboundCertificate -ServiceURI https://nameofyourserver:12290/ 1outboundcerts

After this steps, you probably would need to ptach things up from the Sharepoint side, eg. if you are using your Workflow Manager Farm on your Sharepoint Portal.

Those extra steps would be as below:

Hope that helps

Cheers

Comments

  • Anonymous
    April 13, 2017
    Hi,Is this step valid to change the auto generated Workflow Outbound certificate to a custom CA certificate?Thanks
    • Anonymous
      April 13, 2017
      Hello Sarath, yes you can follow the above steps to change that, remember that the certificate needs to be valid and installed prior to be assigned.
      • Anonymous
        April 13, 2017
        Hi Jose, I was going through the steps mentioned in article (http://www.harbar.net/articles/wfm3.aspx) to update the auto generated certificates to CA certificate and noticed the message as given below:"we cannot change from an auto-generated Outbound Signing certificate to a CA issued Outbound Signing Certificate. This is a significant constraint of Workflow Manager configuration, even though we can update the certificate, workflows will get “stuck” in their initial stage after doing so, as the Workflow Manager farm thinks it’s an auto-generated certificate"I was really worried about reinstalling WFM in order to use same custom CA certificate for Service bus, Workflow Manager and Outbound signing certificate.If above steps is going to work for all kind of these certificates, it will save my time.
      • Anonymous
        April 18, 2017
        Hi Jose,With above commands, I've successfully updated the outbound certificate and the command Get-WFOutboundCertificate gives the correct domain certificate thumbprint. However, Get-WFFarm still returns the old certificate details.. Is this a bug? I m running CU3 in my environment.Regards, Sarath
        • Anonymous
          April 18, 2017
          Hi Sarath, yes its indeed an known issue with the Get-WFFarm Powershell, this is because Get-WFFarm retrieves data from WF Management database and not from WF Resource Management database as Get-WFOutboundCertificate cmdlet does, hence the difference. Workflow runtime is using the thumbprint defined in WF Resource Management so there should not be any problem. This issue exists even in CU3 and is tracked to be fixed in CU4.
          • Anonymous
            April 18, 2017
            Thanks Jose for the quick update!I've a question outside of this article. Would you be able to help with that?Do you have any article stating about the step-by-step procedure for Workflow Manager DR in Warm standby mode? I've asked the same in MS Forum and no reply as of now.Regards, Sarath
  • Anonymous
    April 27, 2017
    Hi Jose,Need a quick help. If our SharePoint sites are accessed from external network, do we need an external certificate as WF, Service Bus and Outbound signing certificate? Or domain CA issued certificate can be used without any certificate error?
    • Anonymous
      April 27, 2017
      Hi Sarath, as long as the WFM Certificate matches the FQDN of the Server and its installed on the Sharepoint Frontend Servers connected with the WFM Farm you should have no issues.
      • Anonymous
        April 28, 2017
        The comment has been removed
  • Anonymous
    May 01, 2017
    This was very helpful. I had to replace an expired certificate, and didn't have time to take a Workflow Manager class or dig through the disjoint TechNet information. This is exactly what I needed and it worked perfectly.Thanks much!