Configurar Workflow Manager en SharePoint 2016

Workflow Manager es el motor para ejecutar flujos de trabajo basados en listas en SharePoint. Esta guía cubre la configuración, el registro y la resolución de problemas de Workflow Manager 1.0 en SharePoint 2016.

Configuración paso a paso

Recomendado:

• SharePoint 2016 - Step by Step Installation of Workflow Manager (TechNet)

Problemas comunes y soluciones

Error: Register Workflow Proxy for SharePoint Servers

Si ves un error en este paso, usa esta solución:

• Workflow Manager Exception - SPWorkflowService failed to query the OAuth S2S metadata (Ahmed Madany blog)

cls
Add-PSSnapin microsoft.sharepoint.powershell
$config = (Get-SPSecurityTokenServiceConfig)
$config.AllowOAuthOverHttp = $true
$config.AllowMetaDataOverHttp = $true
# $config.Update()

Service Bus atascado en el estado "Starting"

Si Service Bus no arranca, consulta:

• Running Service Bus Server on a legacy domain without a fully qualified domain name (MSDN)

Ejemplo de solicitud de certificado

Usa esta configuración para solicitar un certificado:

[Version]
Signature = "$Windows NT$"

[Strings]
szOID_SUBJECT_ALT_NAME2 = "2.5.29.17"
szOID_ENHANCED_KEY_USAGE = "2.5.29.37"
szOID_PKIX_KP_SERVER_AUTH = "1.3.6.1.5.5.7.3.1"

[NewRequest]
Subject = "CN=ksup-web"
KeySpec = AT_KEYEXCHANGE
KeyUsage = "CERT_DIGITAL_SIGNATURE_KEY_USAGE | CERT_KEY_ENCIPHERMENT_KEY_USAGE"
MachineKeySet = true
RequestType = cert
Exportable = true
KeyLength=2048
ValidityPeriodUnits = 5
ValidityPeriod = Years
HashAlgorithm = sha256

[Extensions]
%szOID_SUBJECT_ALT_NAME2% = "{text}"
_continue_ = "DNS=<HOST>&"
_continue_ = "DNS=<HOST>&"

%szOID_ENHANCED_KEY_USAGE% = "{text}"
_continue_ = %szOID_PKIX_KP_SERVER_AUTH%

Reconfiguración del host de Service Bus:

cls
Remove-SBHost
# Get-SBFarm -SBFarmDBConnectionString "Data Source=<HOST>;Initial Catalog=ServiceBus_Management_DB;Integrated Security=True;Encrypt=False"
# Set-SBCertificate -EncryptionCertificateThumbprint <THUMBPRINT> -FarmCertificateThumbprint <THUMBPRINT> -SBFarmDBConnectionString "Data Source=<HOST>;Initial Catalog=ServiceBus_Management_DB;Integrated Security=True;Encrypt=False"
Add-SBHost

Certificado caducado

Error:

The provided signing certificate is invalid according to its expiration claims.

Solución:

• Renew self-signed certificate for Service Bus and Workflow Manager (it-kb.ru)

Varios dominios (por ejemplo, mydomain y mydomain.local)

Si tienes varios dominios y obtienes un error durante el último paso (añadir el host al Workflow Manager Farm):

Workflow Manager configuration starting. Configuring Workflow Manager runtime settings. The token provider was unable to provide a security token while accessing 'https://*:9355/WorkflowDefaultNamespace/$STS/Windows/'. Token provider returned message: 'The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel.'

Necesitas solicitar un certificado SSL que incluya todos los nombres de dominio.

• Guide: Requesting an SSL Certificate for Multiple Domains

Ejemplo:

continue = "dns=www.maindomain.com&"
continue = "dns=www.domain2.com&"
continue = "dns=maindomain.com&"
continue = "dns=domain2.com&"

Después de eso:

1. Inicia Workflow Configuration Manager.
2. En el primer paso, selecciona Auto Generate Certificate.
3. En el segundo paso (configuración de Service Bus), desmarca Manual Configuration y adjunta el certificado multi-dominio recién creado.
4. Asegúrate de que el certificado esté instalado en el almacén Trusted Root Certification Authorities.

Con estos pasos completados, Workflow Manager debería quedar correctamente configurado y totalmente operativo, incluso en entornos de dominio complejos.