'Declaration
 
<NotNullAttribute()>
Function StartNewKeyPairRequest( _
   ByVal gdsEndpointDescriptor As UAEndpointDescriptor, _
   ByVal applicationId As UANodeId, _
   ByVal certificateGroupId As UANodeId, _
   ByVal certificateTypeId As UANodeId, _
   ByVal subjectName As String, _
   ByVal domainNames As IEnumerable(Of String), _
   ByVal privateKeyFormat As String, _
   ByVal privateKeyPassword As String _
) As UANodeId

'Usage
 
Dim instance As IEasyUACertificateManagement
Dim gdsEndpointDescriptor As UAEndpointDescriptor
Dim applicationId As UANodeId
Dim certificateGroupId As UANodeId
Dim certificateTypeId As UANodeId
Dim subjectName As String
Dim domainNames As IEnumerable(Of String)
Dim privateKeyFormat As String
Dim privateKeyPassword As String
Dim value As UANodeId
 
value = instance.StartNewKeyPairRequest(gdsEndpointDescriptor, applicationId, certificateGroupId, certificateTypeId, subjectName, domainNames, privateKeyFormat, privateKeyPassword)

[NotNull()]
UANodeId StartNewKeyPairRequest( 
   UAEndpointDescriptor gdsEndpointDescriptor,
   UANodeId applicationId,
   UANodeId certificateGroupId,
   UANodeId certificateTypeId,
   string subjectName,
   IEnumerable<string> domainNames,
   string privateKeyFormat,
   string privateKeyPassword
)

[NotNull()]
UANodeId^ StartNewKeyPairRequest( 
   UAEndpointDescriptor^ gdsEndpointDescriptor,
   UANodeId^ applicationId,
   UANodeId^ certificateGroupId,
   UANodeId^ certificateTypeId,
   String^ subjectName,
   IEnumerable<String^>^ domainNames,
   String^ privateKeyFormat,
   String^ privateKeyPassword
) 

Parameters

gdsEndpointDescriptor

Endpoint descriptor. Identifies the OPC-UA server. The server must be a Global Directory Server (GDS).

applicationId

The identifier assigned to the Application Instance by the CertificateManager.

certificateGroupId

The NodeId of the Certificate Group which provides the context for the new request.
If OpcLabs.EasyOpc.UA.AddressSpace.UANodeId.Null the CertificateManager shall choose the DefaultApplicationGroup.

certificateTypeId

The NodeId of the CertificateType for the new Certificate.
If OpcLabs.EasyOpc.UA.AddressSpace.UANodeId.Null the CertificateManager shall generate a Certificate based on the value of the certificateGroupId argument.

subjectName

The subject name to use for the Certificate.
If not specified the ApplicationName and/or domainNames are used to create a suitable default value.
The format of the subject name is a sequence of name value pairs separated by a ‘/’. The name shall be one of ‘CN’, ‘O’, ‘OU’, ‘DC’, ‘L’, ‘S’ or ‘C’ and shall be followed by a ‘=’ and then followed by the value. The value may be any printable character except for ‘”’. If the value contains a ‘/’ or a ‘=’ then it shall be enclosed in double quotes (‘”’).

domainNames

The domain names to include in the Certificate.
If not specified the DiscoveryUrls are used to create suitable defaults.

privateKeyFormat

The format of the private key.
The following values are always supported:
PFX - PKCS #12 encoded
PEM - Base64 encoded DER(see RFC 5958).

privateKeyPassword

The password to use for the private key.

Return Value

If you want to obtain new certificate for the current client application, it is recommended that you use the higher-level OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.BeginObtainNewCertificate method instead.

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2016, Windows Server 2022; .NET: Linux, macOS, Microsoft Windows