Struct cloudkeys::OAuth

Properties   Methods   Events   Config Settings   Errors  

The OAuth struct is used to authorize a client and provide an authorization string used in future requests.

Syntax

cloudkeys::OAuth

Remarks

The OAuth struct supports both plaintext and Secure Sockets Layer/Transport Layer Security (SSL/TLS) connections. When connecting over Secure Sockets Layer/Transport Layer Security (SSL/TLS) the on_ssl_server_authentication event allows you to check the server identity and other security attributes. The on_ssl_status event provides information about the SSL handshake. Additional SSL-related settings are also supported through the config method.

The OAuth struct provides an easy way to obtain an authorization string for future requests to a service. The struct implements an OAuth 2.0 client.

To begin using the struct, first register your application with the service you want to use. During this process, obtain a client_id and client_secret as well as the server_auth_url and server_token_url for the authorization server. Then set client_profile to the client profile that best describes your situation and call get_authorization.

The following client profiles are currently supported by the struct:

• Application (desktop application)
• Web (server-side application, such as a website)
• Device (an application without browser access, such as a game console)
• Mobile (phone or tablet application)
• JWT (server-to-server authentication using a JWT Bearer Token, such as Google service account authentication)

Application Profile

The Application profile is applicable to applications that are run directly by the user. For instance, a Windows form application would use the Application profile. To authorize your application (client) using the Application profile, use the following steps:

First, set client_profile to ocpApplication. This defines the profile the struct will use. Set the client_id, client_secret, server_auth_url, and server_token_url to the values you obtained when registering your application.

Second, call get_authorization to begin the authorization process. When get_authorization is called, the struct will build the URL to which the user will be directed and fire the on_launch_browser event. The struct will then launch the browser using the command and URL shown in the on_launch_browser event and await the response. The duration for which the struct will wait for a response is defined by BrowserResponseTimeout.

Third, the user will interact with the browser to authenticate and grant access to the connecting application. The user will then be redirected back to an embedded web server that was automatically started when get_authorization was called. At this time, the on_return_url event will fire. This event provides an opportunity to provide a custom response to your user that they will see in their browser.

Fourth, the struct will then automatically exchange the grant that was returned by the authorization server for the access token using the HTTP endpoint specified in server_token_url.

The authorization is now complete and the get_authorization method will return the authorization string. The authorization string can then be used with any of our components by simply setting the returned value to the authorization property before making a request.

The following is a simple example: component.ClientId = "CLIENT_ID"; component.ClientSecret = "CLIENT_ID"; component.ServerAuthURL = "https://accounts.google.com/o/oauth2/auth"; component.ServerTokenURL = "https://accounts.google.com/o/oauth2/token"; HTTP.Authorization = component.GetAuthorization(); HTTP.Get("https://www.googleapis.com/oauth2/v1/userinfo");

Web Profile

The Web profile is applicable to applications that are run on the server side when the user uses the application from a web browser. To authorize your application (client) using this profile, use the following steps:

First, set client_profile to ocpWeb. This defines the profile the component will use. Set the client_id, client_secret, server_auth_url, and server_token_url to the values you obtained when registering your application. Set return_url to the page on your site that will be the endpoint the user is redirected back to after authentication.

Second, call get_authorization_url. This will return a URL to which the user should be redirected. Redirect the user to this URL.

Third, after the user authenticates and is returned to the page on your site specified by return_url, parse the "code" query string parameter from the incoming request to get the authorization code from the authorization server. Then, set authorization_code property to the parsed value.

Fourth, after authorization_code is set, call get_authorization to exchange the code specified in authorization_code for a token from the server specified by server_token_url. get_authorization will then return the authorization string. The authorization string can be used with any of our components by simply setting the returned value to the authorization property before making a request.

Device Profile

The Device profile is applicable to applications that are run on devices for which a web browser cannot be used. For example, a game console would use the Device profile. To authorize your application (client) using the device client profile use the following steps:

First, set client_profile to ocpDevice. This defines the profile the struct will use. Set the client_id, client_secret, server_auth_url, and server_token_url to the values you obtained when registering your application. Do not set return_url.

Second, call get_authorization_url. The struct will automatically make a request to server_auth_url to obtain a user code for the device. The get_authorization_url method will return the URL your user must visit from another device or computer that has web browser support. The get_authorization_url method will also populate DeviceUserCode. This device user code must be provided to the user. The user will enter the code at the URL returned by get_authorization_url.

Third, at this time, call get_authorization. The struct will begin polling the server specified in server_token_url. The polling interval is specified (in seconds) by the PollingInterval setting.

Fourth, after the user has authenticated, the get_authorization method will return the authorization string. To use the authorization string with any of our components, simply pass this value to the authorization property before making the request.

Mobile Profile

The Mobile profile is applicable to applications that are run on devices for which a web browser can be used. For instance, a mobile phone or tablet would use the Mobile profile. The behavior when using this profile is very similar to the Application profile. The only difference between the Mobile and Application profiles is the way the browser is launched. When set to the Mobile profile, the on_launch_browser event will fire but the struct will not attempt to launch the browser automatically. The browser must be launched manually from code. This behavior is the only difference between the Mobile and Application profiles. Please read the steps for the Application profile for a more detailed look at the process.

JWT Bearer Token (Server-to-Server) Profile

The JWT (JSON Web Token) Bearer Token profile is available for server-to-server authentication. For instance this may be used by web applications to access a Google service. In this case, the application will access data on behalf of the service account, not the end user. End-user interaction is not required.

First, specify authorization_scope server_token_url and JWTServiceProvider.

Second, specify JWT-specific values. The use of the JWT profile also requires additional configuration settings to be specified, including a certificate with private key used to sign the JWT. Either specify the JWTJSONKey configuration setting, which will parse the necessary information automatically, or manually specify the following configuration settings:

• JWTIssuer (required)
• JWTAudience (required)
• JWTCertStoreType (required)
• JWTCertStore (required)
• JWTCertStorePassword (required)
• JWTCertSubject (required)
• JWTSubject
• JWTValidityTime
• JWTSignatureAlgorithm

Example 1. Google: oauth.AuthorizationScope = "https://www.googleapis.com/auth/analytics"; oauth.ServerTokenURL = "https://www.googleapis.com/oauth2/v3/token"; oauth.ClientProfile = OauthClientProfiles.ocpJWT; oauth.Config("JWTServiceProvider=0"); oauth.Config("JWTIssuer=CLIENT_ID"); oauth.Config("JWTAudience=https://www.googleapis.com/oauth2/v3/token"); oauth.Config("JWTCertStoreType=2"); oauth.Config("JWTCertStore=C:\\MyCertificate.p12"); oauth.Config("JWTCertStorePassword=password"); oauth.Config("JWTCertSubject=*"); oauth.Config("JWTValidityTime=5400"); //in seconds string authStr = oauth.GetAuthorization();

Example 2. Microsoft: oauth.ClientId = "Client_Id"; oauth.ClientProfile = OauthClientProfiles.ocpJWT; oauth.AuthorizationScope = "https://graph.microsoft.com/.default"; oauth.ServerTokenURL = "https://login.microsoftonline.com/" + tenant_id + "/oauth2/V2.0/token"; oauth.Config("JWTServiceProvider=1"); oauth.Config("JWTIssuer=" + CLIENT_ID); oauth.Config("JWTSubject=" + CLIENT_ID); oauth.Config("JWTCertStoreType=2"); oauth.Config("JWTCertStore=C:\\MyCertificate.p12"); oauth.Config("JWTCertStorePassword=password"); oauth.Config("JWTCertSubject=*"); oauth.Config("JWTValidityTime=3600"); oauth.Config("JWTAudience=https://login.microsoftonline.com/"+ tenant_id + "/oauth2/V2.0/token"); string authStr = oauth.GetAuthorization();

Custom Responses

When using a profile that makes use of the embedded web server, the response that is displayed to the user on success of failure may be customized to include a variety of product- and company-specific information. The following section is applicable only when the embedded web server is used, for instance, when client_profile is set to ocpApplication.

By default, the struct will display a formatted result message indicating whether the authorization succeeded or failed. The following optional settings control the text of the message as well as product images, company logos, and links for help or licensing terms that can be displayed to the user.

Alternatively, for complete control, set the WebServerResponse and WebServerFailedResponse settings to the full HTML to be displayed to the user.

Object Lifetime

The new() method returns a mutable reference to a struct instance. The object itself is kept in the global list maintained by CloudKeys. Due to this, the OAuth struct cannot be disposed of automatically. Please, call the dispose(&mut self) method of OAuth when you have finished using the instance.

Property List

The following is the full list of the properties of the struct with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the struct with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the struct with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the struct with short descriptions. Click on the links for further details.

access_token property (OAuth Struct)

The access token returned by the authorization server.

Syntax

fn access_token(&self ) -> Result<String, CloudKeysError> 
fn set_access_token(&self, value : &str) ->  Option<CloudKeysError> 
fn set_access_token_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

This property will be populated with the access token returned by the authorization server after a call to get_authorization. This will be the raw access token, whereas the return value from the get_authorization method will also include the required data so that it can be passed directly to the Authorization property of other components or added as the value of the authorization header in another client implementation.

Data Type

String

access_token_exp property (OAuth Struct)

The lifetime of the access token.

Syntax

fn access_token_exp(&self ) -> Result<i32, CloudKeysError> 

Default Value

0

Remarks

This setting holds the lifetime of the access token in seconds. For instance the value 3600 indicates that the token will expire in one hour from the time it was generated.

This property is read-only.

Data Type

i32

authorization_code property (OAuth Struct)

The authorization code that is exchanged for an access token.

Syntax

fn authorization_code(&self ) -> Result<String, CloudKeysError> 
fn set_authorization_code(&self, value : &str) ->  Option<CloudKeysError> 
fn set_authorization_code_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

This property is used with the AuthorizationCode grant_type. When client_profile is set to ocpApplication (Application flow), this property will be informational only, as the get_authorization method will automatically exchange this code for a token with the authorization server specified in server_token_url.

When client_profile is set to ocpWeb (Web flow), this property needs to be set to the authorization code returned from the authorization server. Typically, this value is parsed when the service redirects the user back to your website. See client_profile for more information.

If this property is set before calling get_authorization, the struct will not make a request to the authorization sever and instead will attempt to exchange the code with the authorization server for an access token.

Data Type

String

authorization_scope property (OAuth Struct)

The scope request or response parameter used during authorization.

Syntax

fn authorization_scope(&self ) -> Result<String, CloudKeysError> 
fn set_authorization_scope(&self, value : &str) ->  Option<CloudKeysError> 
fn set_authorization_scope_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

If the scope is not set, the authorization server will use the default access scope for your application as determined by the server. To request a specific access scope, set this property to a space-separated list of strings as defined by the authorization server.

After calling get_authorization, this property will be updated with the scope sent in the response from the server and will indicate the scope that was actually granted.

Data Type

String

client_id property (OAuth Struct)

The Id of the client assigned when registering the application.

Syntax

fn client_id(&self ) -> Result<String, CloudKeysError> 
fn set_client_id(&self, value : &str) ->  Option<CloudKeysError> 
fn set_client_id_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

This property holds the Id of the client that was assigned when initially registering the application with the authorization server. This value must be specified before calling get_authorization or get_authorization_url.

Data Type

String

client_profile property (OAuth Struct)

The type of client that is requesting authorization.

Syntax

fn client_profile(&self ) -> Result<i32, CloudKeysError> 
fn set_client_profile(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // Application
1   // Web
2   // Device
3   // Mobile
4   // JWT

Default Value

0

Remarks

This defines the type of client that will be requesting authorization. Set this before calling get_authorization to inform the struct to act accordingly. Possible values are as follows:

Application Profile

The Application profile is applicable to applications that are run directly by the user. For instance, a Windows form application would use the Application profile. To authorize your application (client) using the Application profile, use the following steps:

First, set client_profile to ocpApplication. This defines the profile the struct will use. Set the client_id, client_secret, server_auth_url, and server_token_url to the values you obtained when registering your application.

Second, call get_authorization to begin the authorization process. When get_authorization is called, the struct will build the URL to which the user will be directed and fire the on_launch_browser event. The struct will then launch the browser using the command and URL shown in the on_launch_browser event and await the response. The duration for which the struct will wait for a response is defined by BrowserResponseTimeout.

Third, the user will interact with the browser to authenticate and grant access to the connecting application. The user will then be redirected back to an embedded web server that was automatically started when get_authorization was called. At this time, the on_return_url event will fire. This event provides an opportunity to provide a custom response to your user that they will see in their browser.

Fourth, the struct will then automatically exchange the grant that was returned by the authorization server for the access token using the HTTP endpoint specified in server_token_url.

The authorization is now complete and the get_authorization method will return the authorization string. The authorization string can then be used with any of our components by simply setting the returned value to the authorization property before making a request.

The following is a simple example: component.ClientId = "CLIENT_ID"; component.ClientSecret = "CLIENT_ID"; component.ServerAuthURL = "https://accounts.google.com/o/oauth2/auth"; component.ServerTokenURL = "https://accounts.google.com/o/oauth2/token"; HTTP.Authorization = component.GetAuthorization(); HTTP.Get("https://www.googleapis.com/oauth2/v1/userinfo");

Web Profile

The Web profile is applicable to applications that are run on the server side when the user uses the application from a web browser. To authorize your application (client) using this profile, use the following steps:

First, set client_profile to ocpWeb. This defines the profile the component will use. Set the client_id, client_secret, server_auth_url, and server_token_url to the values you obtained when registering your application. Set return_url to the page on your site that will be the endpoint the user is redirected back to after authentication.

Second, call get_authorization_url. This will return a URL to which the user should be redirected. Redirect the user to this URL.

Third, after the user authenticates and is returned to the page on your site specified by return_url, parse the "code" query string parameter from the incoming request to get the authorization code from the authorization server. Then, set authorization_code property to the parsed value.

Fourth, after authorization_code is set, call get_authorization to exchange the code specified in authorization_code for a token from the server specified by server_token_url. get_authorization will then return the authorization string. The authorization string can be used with any of our components by simply setting the returned value to the authorization property before making a request.

Device Profile

The Device profile is applicable to applications that are run on devices for which a web browser cannot be used. For example, a game console would use the Device profile. To authorize your application (client) using the device client profile use the following steps:

First, set client_profile to ocpDevice. This defines the profile the struct will use. Set the client_id, client_secret, server_auth_url, and server_token_url to the values you obtained when registering your application. Do not set return_url.

Second, call get_authorization_url. The struct will automatically make a request to server_auth_url to obtain a user code for the device. The get_authorization_url method will return the URL your user must visit from another device or computer that has web browser support. The get_authorization_url method will also populate DeviceUserCode. This device user code must be provided to the user. The user will enter the code at the URL returned by get_authorization_url.

Third, at this time, call get_authorization. The struct will begin polling the server specified in server_token_url. The polling interval is specified (in seconds) by the PollingInterval setting.

Fourth, after the user has authenticated, the get_authorization method will return the authorization string. To use the authorization string with any of our components, simply pass this value to the authorization property before making the request.

Mobile Profile

The Mobile profile is applicable to applications that are run on devices for which a web browser can be used. For instance, a mobile phone or tablet would use the Mobile profile. The behavior when using this profile is very similar to the Application profile. The only difference between the Mobile and Application profiles is the way the browser is launched. When set to the Mobile profile, the on_launch_browser event will fire but the struct will not attempt to launch the browser automatically. The browser must be launched manually from code. This behavior is the only difference between the Mobile and Application profiles. Please read the steps for the Application profile for a more detailed look at the process.

JWT Bearer Token (Server-to-Server) Profile

The JWT (JSON Web Token) Bearer Token profile is available for server-to-server authentication. For instance this may be used by web applications to access a Google service. In this case, the application will access data on behalf of the service account, not the end user. End-user interaction is not required.

First, specify authorization_scope server_token_url and JWTServiceProvider.

Second, specify JWT-specific values. The use of the JWT profile also requires additional configuration settings to be specified, including a certificate with private key used to sign the JWT. Either specify the JWTJSONKey configuration setting, which will parse the necessary information automatically, or manually specify the following configuration settings:

• JWTIssuer (required)
• JWTAudience (required)
• JWTCertStoreType (required)
• JWTCertStore (required)
• JWTCertStorePassword (required)
• JWTCertSubject (required)
• JWTSubject
• JWTValidityTime
• JWTSignatureAlgorithm

Example 1. Google: oauth.AuthorizationScope = "https://www.googleapis.com/auth/analytics"; oauth.ServerTokenURL = "https://www.googleapis.com/oauth2/v3/token"; oauth.ClientProfile = OauthClientProfiles.ocpJWT; oauth.Config("JWTServiceProvider=0"); oauth.Config("JWTIssuer=CLIENT_ID"); oauth.Config("JWTAudience=https://www.googleapis.com/oauth2/v3/token"); oauth.Config("JWTCertStoreType=2"); oauth.Config("JWTCertStore=C:\\MyCertificate.p12"); oauth.Config("JWTCertStorePassword=password"); oauth.Config("JWTCertSubject=*"); oauth.Config("JWTValidityTime=5400"); //in seconds string authStr = oauth.GetAuthorization();

Example 2. Microsoft: oauth.ClientId = "Client_Id"; oauth.ClientProfile = OauthClientProfiles.ocpJWT; oauth.AuthorizationScope = "https://graph.microsoft.com/.default"; oauth.ServerTokenURL = "https://login.microsoftonline.com/" + tenant_id + "/oauth2/V2.0/token"; oauth.Config("JWTServiceProvider=1"); oauth.Config("JWTIssuer=" + CLIENT_ID); oauth.Config("JWTSubject=" + CLIENT_ID); oauth.Config("JWTCertStoreType=2"); oauth.Config("JWTCertStore=C:\\MyCertificate.p12"); oauth.Config("JWTCertStorePassword=password"); oauth.Config("JWTCertSubject=*"); oauth.Config("JWTValidityTime=3600"); oauth.Config("JWTAudience=https://login.microsoftonline.com/"+ tenant_id + "/oauth2/V2.0/token"); string authStr = oauth.GetAuthorization();

Data Type

i32

client_secret property (OAuth Struct)

The secret value for the client assigned when registering the application.

Syntax

fn client_secret(&self ) -> Result<String, CloudKeysError> 
fn set_client_secret(&self, value : &str) ->  Option<CloudKeysError> 
fn set_client_secret_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

This property holds the secret of the client that was assigned when initially registering the application with the authorization server. This value must be specified before calling get_authorization or get_authorization_url.

Data Type

String

connected property (OAuth Struct)

Whether the struct is connected.

Syntax

fn connected(&self ) -> Result<bool, CloudKeysError> 

Default Value

false

Remarks

This property is used to determine whether or not the struct is connected to the remote host. Use the connect and disconnect methods to manage the connection.

This property is read-only.

Data Type

bool

cookie_count property (OAuth Struct)

The number of records in the Cookie arrays.

Syntax

fn cookie_count(&self ) -> Result<i32, CloudKeysError> 
fn set_cookie_count(&self, value : i32) ->  Option<CloudKeysError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• cookie_domain
• cookie_expiration
• cookie_name
• cookie_path
• cookie_secure
• cookie_value

The array indices start at 0 and end at cookie_count - 1.

Data Type

i32

cookie_domain property (OAuth Struct)

The domain of a received cookie.

Syntax

fn cookie_domain(&self , CookieIndex : i32) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The domain of a received cookie. This property contains a domain name to limit the cookie to (if provided by the server). If the server does not provide a domain name, this property will contain an empty string. The convention in this case is to use the server name specified by url_server as the cookie domain.

The CookieIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CookieCount property.

This property is read-only.

Data Type

String

cookie_expiration property (OAuth Struct)

An expiration time for the cookie (if provided by the server).

Syntax

fn cookie_expiration(&self , CookieIndex : i32) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

An expiration time for the cookie (if provided by the server). The time format used is "Weekday, DD-Mon-YY HH:MM:SS GMT". If the server does not provide an expiration time, this property will contain an empty string. The convention is to drop the cookie at the end of the session.

The CookieIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CookieCount property.

This property is read-only.

Data Type

String

cookie_name property (OAuth Struct)

The name of the cookie.

Syntax

fn cookie_name(&self , CookieIndex : i32) -> Result<String, CloudKeysError> 
fn set_cookie_name(&self, CookieIndex : i32, value : &str) ->  Option<CloudKeysError> 
fn set_cookie_name_ref(&self, CookieIndex : i32, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The name of the cookie.

This property, along with cookie_value, stores the cookie that is to be sent to the server. The on_set_cookie event displays the cookies sent by the server and their properties.

The CookieIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CookieCount property.

Data Type

String

cookie_path property (OAuth Struct)

A path name to limit the cookie to (if provided by the server).

Syntax

fn cookie_path(&self , CookieIndex : i32) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

A path name to limit the cookie to (if provided by the server). If the server does not provide a cookie path, the path property will be an empty string. The convention in this case is to use the path specified by url_path as the cookie path.

The CookieIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CookieCount property.

This property is read-only.

Data Type

String

cookie_secure property (OAuth Struct)

The security flag of the received cookie.

Syntax

fn cookie_secure(&self , CookieIndex : i32) -> Result<bool, CloudKeysError> 

Default Value

false

Remarks

The security flag of the received cookie. This property specifies whether the cookie is secure. If the value of this property is True, the cookie value must be submitted only through a secure (HTTPS) connection.

The CookieIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CookieCount property.

This property is read-only.

Data Type

bool

cookie_value property (OAuth Struct)

The value of the cookie.

Syntax

fn cookie_value(&self , CookieIndex : i32) -> Result<String, CloudKeysError> 
fn set_cookie_value(&self, CookieIndex : i32, value : &str) ->  Option<CloudKeysError> 
fn set_cookie_value_ref(&self, CookieIndex : i32, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The value of the cookie. A corresponding value is associated with the cookie specified by cookie_name. This property holds that value.

The on_set_cookie event provides the cookies set by the server.

The CookieIndex parameter specifies the index of the item in the array. The size of the array is controlled by the CookieCount property.

Data Type

String

firewall_auto_detect property (OAuth Struct)

Whether to automatically detect and use firewall system settings, if available.

Syntax

fn firewall_auto_detect(&self ) -> Result<bool, CloudKeysError> 
fn set_firewall_auto_detect(&self, value : bool) ->  Option<CloudKeysError> 

Default Value

false

Remarks

Whether to automatically detect and use firewall system settings, if available.

Data Type

bool

firewall_type property (OAuth Struct)

The type of firewall to connect through.

Syntax

fn firewall_type(&self ) -> Result<i32, CloudKeysError> 
fn set_firewall_type(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // None
1   // Tunnel
2   // SOCKS4
3   // SOCKS5
10   // SOCKS4A

Default Value

0

Remarks

The type of firewall to connect through. The applicable values are as follows:

Data Type

i32

firewall_host property (OAuth Struct)

The name or IP address of the firewall (optional).

Syntax

fn firewall_host(&self ) -> Result<String, CloudKeysError> 
fn set_firewall_host(&self, value : &str) ->  Option<CloudKeysError> 
fn set_firewall_host_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The name or IP address of the firewall (optional). If a firewall_host is given, the requested connections will be authenticated through the specified firewall when connecting.

If this property is set to a Domain Name, a DNS request is initiated. Upon successful termination of the request, this property is set to the corresponding address. If the search is not successful, the struct fails with an error.

Data Type

String

firewall_password property (OAuth Struct)

A password if authentication is to be used when connecting through the firewall.

Syntax

fn firewall_password(&self ) -> Result<String, CloudKeysError> 
fn set_firewall_password(&self, value : &str) ->  Option<CloudKeysError> 
fn set_firewall_password_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

A password if authentication is to be used when connecting through the firewall. If firewall_host is specified, the firewall_user and firewall_password properties are used to connect and authenticate to the given firewall. If the authentication fails, the struct fails with an error.

Data Type

String

firewall_port property (OAuth Struct)

The Transmission Control Protocol (TCP) port for the firewall Host .

Syntax

fn firewall_port(&self ) -> Result<i32, CloudKeysError> 
fn set_firewall_port(&self, value : i32) ->  Option<CloudKeysError> 

Default Value

0

Remarks

The Transmission Control Protocol (TCP) port for the firewall firewall_host. See the description of the firewall_host property for details.

NOTE: This property is set automatically when firewall_firewall_type is set to a valid value. See the description of the firewall_firewall_type property for details.

Data Type

i32

firewall_user property (OAuth Struct)

A username if authentication is to be used when connecting through a firewall.

Syntax

fn firewall_user(&self ) -> Result<String, CloudKeysError> 
fn set_firewall_user(&self, value : &str) ->  Option<CloudKeysError> 
fn set_firewall_user_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

A username if authentication is to be used when connecting through a firewall. If firewall_host is specified, this property and the firewall_password property are used to connect and authenticate to the given Firewall. If the authentication fails, the struct fails with an error.

Data Type

String

follow_redirects property (OAuth Struct)

Determines what happens when the server issues a redirect.

Syntax

fn follow_redirects(&self ) -> Result<i32, CloudKeysError> 
fn set_follow_redirects(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // Never
1   // Always
2   // SameScheme

Default Value

0

Remarks

This property determines what happens when the server issues a redirect. Normally, the struct returns an error if the server responds with an "Object Moved" message. If this property is set to frAlways (1), the new url for the object is retrieved automatically every time.

If this property is set to frSameScheme (2), the new url is retrieved automatically only if the url_scheme is the same; otherwise, the struct fails with an error.

NOTE: Following the HTTP specification, unless this property is set to frAlways (1), automatic redirects will be performed only for GET or HEAD requests. Other methods potentially could change the conditions of the initial request and create security vulnerabilities.

Furthermore, if either the new URL server or port are different from the existing one, user and password are also reset to empty. If, however, this property is set to frAlways (1), the same credentials are used to connect to the new server.

A on_redirect event is fired for every URL the product is redirected to. In the case of automatic redirections, the on_redirect event is a good place to set properties related to the new connection (e.g., new authentication parameters).

The default value is frNever (0). In this case, redirects are never followed, and the struct fails with an error instead.

Data Type

i32

grant_type property (OAuth Struct)

The OAuth grant type used to acquire an OAuth access token.

Syntax

fn grant_type(&self ) -> Result<i32, CloudKeysError> 
fn set_grant_type(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // AuthorizationCode
1   // Implicit
2   // Password
3   // ClientCredentials
4   // AdminConsent

Default Value

0

Remarks

This setting specifies the type of grant to obtain. In most cases the Authorization Code grant type (default) is used, so it is typically not necessary to change this. The supported values are:

For all grant types listed set client_profile to Application.

The Authorization Code grant is the most commonly used grant type. It follows the flow described for the Application Client Profile section in the OAuth introduction page.

Implicit grants are similar to Authorization Code, except that a Bearer token is returned directly from the authorization server without requiring a second step to exchange a code for a bearer token. To use this grant type set:

• client_id
• client_secret
• server_auth_url

The Resource Owner Password Credentials grant type may be used to authenticate on behalf of a resource owner with the owner's credentials. Authentication is performed directly and the user is not prompted to authenticate the application. To use this grant type set:

• PasswordGrantUsername to the username of the resource owner
• client_secret to the password of the resource owner
• client_id optional, set to the client id for the resource
• server_token_url

The Client Credentials grant type is typically used for server-to-server authentication. The client authenticates directly to the authentication server and receives a token without any user interaction. To use this grant type set:

• client_id
• client_secret
• server_token_url

The AdminConsent grant type is used when setting up application permissions for apps that authenticate to Microsoft. To use this grant type set:

• client_id

If the Admin consents to the scopes, the tenant ID can be accessed through the Microsoft365AdminConsentTenant configuration and is often needed for authenticating a client later (eg. Client Credentials Grant Flow). Once the Admin consents once, they typically will not need to go through the process again unless the scopes of the application change.

If the Admin does not consent to the scopes, the error message can be found in the Microsoft365AdminConsentError configuration setting and the error description can be found in the Microsoft365AdminConsentErrorDesc configuration setting.

Data Type

i32

idle property (OAuth Struct)

The current status of the struct.

Syntax

fn idle(&self ) -> Result<bool, CloudKeysError> 

Default Value

true

Remarks

This property will be False if the component is currently busy (communicating or waiting for an answer), and True at all other times.

This property is read-only.

Data Type

bool

local_host property (OAuth Struct)

The name of the local host or user-assigned IP interface through which connections are initiated or accepted.

Syntax

fn local_host(&self ) -> Result<String, CloudKeysError> 
fn set_local_host(&self, value : &str) ->  Option<CloudKeysError> 
fn set_local_host_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

This property contains the name of the local host as obtained by the gethostname() system call, or if the user has assigned an IP address, the value of that address.

In multihomed hosts (machines with more than one IP interface) setting LocalHost to the IP address of an interface will make the struct initiate connections (or accept in the case of server structs) only through that interface. It is recommended to provide an IP address rather than a hostname when setting this property to ensure the desired interface is used.

If the struct is connected, the local_host property shows the IP address of the interface through which the connection is made in internet dotted format (aaa.bbb.ccc.ddd). In most cases, this is the address of the local host, except for multihomed hosts (machines with more than one IP interface).

NOTE: local_host is not persistent. You must always set it in code, and never in the property window.

Data Type

String

other_headers property (OAuth Struct)

Other headers as determined by the user (optional).

Syntax

fn other_headers(&self ) -> Result<String, CloudKeysError> 
fn set_other_headers(&self, value : &str) ->  Option<CloudKeysError> 
fn set_other_headers_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

This property can be set to a string of headers to be appended to the HTTP request headers created from other properties like content_type and from.

The headers must follow the format Header: Value as described in the HTTP specifications. Header lines should be separated by CRLF ("\r\n") .

Use this property with caution. If this property contains invalid headers, HTTP requests may fail.

This property is useful for extending the functionality of the struct beyond what is provided.

Data Type

String

param_count property (OAuth Struct)

The number of records in the Param arrays.

Syntax

fn param_count(&self ) -> Result<i32, CloudKeysError> 
fn set_param_count(&self, value : i32) ->  Option<CloudKeysError> 

Default Value

0

Remarks

This property controls the size of the following arrays:

• param_name
• param_value

The array indices start at 0 and end at param_count - 1.

Data Type

i32

param_name property (OAuth Struct)

The name of the parameter to be used in the request or returned in the response.

Syntax

fn param_name(&self , ParamIndex : i32) -> Result<String, CloudKeysError> 
fn set_param_name(&self, ParamIndex : i32, value : &str) ->  Option<CloudKeysError> 
fn set_param_name_ref(&self, ParamIndex : i32, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The name of the parameter to be used in the request or returned in the response.

The ParamIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ParamCount property.

Data Type

String

param_value property (OAuth Struct)

The value of the parameter to be used in the request or returned in the response.

Syntax

fn param_value(&self , ParamIndex : i32) -> Result<String, CloudKeysError> 
fn set_param_value(&self, ParamIndex : i32, value : &str) ->  Option<CloudKeysError> 
fn set_param_value_ref(&self, ParamIndex : i32, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The value of the parameter to be used in the request or returned in the response. When issuing a request, the struct will URL encode the value specified here. Returned values will be automatically URL decoded.

The ParamIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ParamCount property.

Data Type

String

proxy_auth_scheme property (OAuth Struct)

The type of authorization to perform when connecting to the proxy.

Syntax

fn proxy_auth_scheme(&self ) -> Result<i32, CloudKeysError> 
fn set_proxy_auth_scheme(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // Basic
1   // Digest
2   // Proprietary
3   // None
4   // Ntlm
5   // Negotiate

Default Value

0

Remarks

The type of authorization to perform when connecting to the proxy. This is used only when the proxy_user and proxy_password properties are set.

proxy_auth_scheme should be set to authNone (3) when no authentication is expected.

By default, proxy_auth_scheme is authBasic (0), and if the proxy_user and proxy_password properties are set, the struct will attempt basic authentication.

If proxy_auth_scheme is set to authDigest (1), digest authentication will be attempted instead.

If proxy_auth_scheme is set to authProprietary (2), then the authorization token will not be generated by the struct. Look at the configuration file for the struct being used to find more information about manually setting this token.

If proxy_auth_scheme is set to authNtlm (4), NTLM authentication will be used.

For security reasons, setting this property will clear the values of proxy_user and proxy_password.

Data Type

i32

proxy_auto_detect property (OAuth Struct)

Whether to automatically detect and use proxy system settings, if available.

Syntax

fn proxy_auto_detect(&self ) -> Result<bool, CloudKeysError> 
fn set_proxy_auto_detect(&self, value : bool) ->  Option<CloudKeysError> 

Default Value

false

Remarks

Whether to automatically detect and use proxy system settings, if available. The default value is false.

Data Type

bool

proxy_password property (OAuth Struct)

A password if authentication is to be used for the proxy.

Syntax

fn proxy_password(&self ) -> Result<String, CloudKeysError> 
fn set_proxy_password(&self, value : &str) ->  Option<CloudKeysError> 
fn set_proxy_password_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

A password if authentication is to be used for the proxy.

If proxy_auth_scheme is set to Basic Authentication, the proxy_user and proxy_password properties are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If proxy_auth_scheme is set to Digest Authentication, the proxy_user and proxy_password properties are used to respond to the Digest Authentication challenge from the server.

If proxy_auth_scheme is set to NTLM Authentication, the proxy_user and proxy_password properties are used to authenticate through NTLM negotiation.

Data Type

String

proxy_port property (OAuth Struct)

The Transmission Control Protocol (TCP) port for the proxy Server (default 80).

Syntax

fn proxy_port(&self ) -> Result<i32, CloudKeysError> 
fn set_proxy_port(&self, value : i32) ->  Option<CloudKeysError> 

Default Value

80

Remarks

The Transmission Control Protocol (TCP) port for the proxy proxy_server (default 80). See the description of the proxy_server property for details.

Data Type

i32

proxy_server property (OAuth Struct)

If a proxy Server is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

Syntax

fn proxy_server(&self ) -> Result<String, CloudKeysError> 
fn set_proxy_server(&self, value : &str) ->  Option<CloudKeysError> 
fn set_proxy_server_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

If a proxy proxy_server is given, then the HTTP request is sent to the proxy instead of the server otherwise specified.

If the proxy_server property is set to a domain name, a DNS request is initiated. Upon successful termination of the request, the proxy_server property is set to the corresponding address. If the search is not successful, an error is returned.

Data Type

String

proxy_ssl property (OAuth Struct)

When to use a Secure Sockets Layer (SSL) for the connection to the proxy.

Syntax

fn proxy_ssl(&self ) -> Result<i32, CloudKeysError> 
fn set_proxy_ssl(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // Automatic
1   // Always
2   // Never
3   // Tunnel

Default Value

0

Remarks

When to use a Secure Sockets Layer (SSL) for the connection to the proxy. The applicable values are as follows:

Data Type

i32

proxy_user property (OAuth Struct)

A username if authentication is to be used for the proxy.

Syntax

fn proxy_user(&self ) -> Result<String, CloudKeysError> 
fn set_proxy_user(&self, value : &str) ->  Option<CloudKeysError> 
fn set_proxy_user_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

A username if authentication is to be used for the proxy.

If proxy_auth_scheme is set to Basic Authentication, the proxy_user and proxy_password properties are Base64 encoded and the proxy authentication token will be generated in the form Basic [encoded-user-password].

If proxy_auth_scheme is set to Digest Authentication, the proxy_user and proxy_password properties are used to respond to the Digest Authentication challenge from the server.

If proxy_auth_scheme is set to NTLM Authentication, the proxy_user and proxy_password properties are used to authenticate through NTLM negotiation.

Data Type

String

refresh_token property (OAuth Struct)

The refresh token received from or sent to the authorization server.

Syntax

fn refresh_token(&self ) -> Result<String, CloudKeysError> 
fn set_refresh_token(&self, value : &str) ->  Option<CloudKeysError> 
fn set_refresh_token_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

When get_authorization is called, if the authorization server returns a refresh token along with the access token, this property will hold the refresh token. Save this value for later use.

When your access token expires, set this property to the corresponding refresh token. Then call get_authorization, and the struct will use this token to retrieve a new access token. The new authorization string will be returned by the get_authorization method. No user interaction is required when refreshing an access token.

Data Type

String

return_url property (OAuth Struct)

The URL where the user (browser) returns after authenticating.

Syntax

fn return_url(&self ) -> Result<String, CloudKeysError> 
fn set_return_url(&self, value : &str) ->  Option<CloudKeysError> 
fn set_return_url_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

When client_profile is set to ocpApplication, this will be automatically set to the address of the local embedded web server. In that case, this property can be inspected to determine the URL where the user will be redirected, but it does not need to be set.

When calling get_authorization_url, which is common when client_profile is set to ocpWeb, set this property to the URL on your server where the user will be redirected after authenticating with the authorization server.

This property corresponds to the redirect_uri query string parameter.

Data Type

String

server_auth_url property (OAuth Struct)

The URL of the authorization server.

Syntax

fn server_auth_url(&self ) -> Result<String, CloudKeysError> 
fn set_server_auth_url(&self, value : &str) ->  Option<CloudKeysError> 
fn set_server_auth_url_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

This property specifies the URL of the authorization server used when get_authorization is called. This value is used when constructing the URL to which the user will be redirected to authenticate and grant access.

This should be specified before calling get_authorization.

Data Type

String

server_token_url property (OAuth Struct)

The URL used to obtain the access token.

Syntax

fn server_token_url(&self ) -> Result<String, CloudKeysError> 
fn set_server_token_url(&self, value : &str) ->  Option<CloudKeysError> 
fn set_server_token_url_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The property specifies the URL where the grant will be exchanged for the access token. This is typically a separate HTTP endpoint on the authorization server.

This must be set before calling get_authorization.

Data Type

String

ssl_accept_server_cert_effective_date property (OAuth Struct)

The date on which this certificate becomes valid.

Syntax

fn ssl_accept_server_cert_effective_date(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

ssl_accept_server_cert_expiration_date property (OAuth Struct)

The date on which the certificate expires.

Syntax

fn ssl_accept_server_cert_expiration_date(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

ssl_accept_server_cert_extended_key_usage property (OAuth Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn ssl_accept_server_cert_extended_key_usage(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

ssl_accept_server_cert_fingerprint property (OAuth Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn ssl_accept_server_cert_fingerprint(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

ssl_accept_server_cert_fingerprint_sha1 property (OAuth Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn ssl_accept_server_cert_fingerprint_sha1(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

ssl_accept_server_cert_fingerprint_sha256 property (OAuth Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn ssl_accept_server_cert_fingerprint_sha256(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

ssl_accept_server_cert_issuer property (OAuth Struct)

The issuer of the certificate.

Syntax

fn ssl_accept_server_cert_issuer(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

ssl_accept_server_cert_private_key property (OAuth Struct)

The private key of the certificate (if available).

Syntax

fn ssl_accept_server_cert_private_key(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The ssl_accept_server_cert_private_key may be available but not exportable. In this case, ssl_accept_server_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

ssl_accept_server_cert_private_key_available property (OAuth Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn ssl_accept_server_cert_private_key_available(&self ) -> Result<bool, CloudKeysError> 

Default Value

false

Remarks

Whether a ssl_accept_server_cert_private_key is available for the selected certificate. If ssl_accept_server_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

ssl_accept_server_cert_private_key_container property (OAuth Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn ssl_accept_server_cert_private_key_container(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The name of the ssl_accept_server_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

ssl_accept_server_cert_public_key property (OAuth Struct)

The public key of the certificate.

Syntax

fn ssl_accept_server_cert_public_key(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

ssl_accept_server_cert_public_key_algorithm property (OAuth Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn ssl_accept_server_cert_public_key_algorithm(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_accept_server_cert_public_key_length property (OAuth Struct)

The length of the certificate's public key (in bits).

Syntax

fn ssl_accept_server_cert_public_key_length(&self ) -> Result<i32, CloudKeysError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

ssl_accept_server_cert_serial_number property (OAuth Struct)

The serial number of the certificate encoded as a string.

Syntax

fn ssl_accept_server_cert_serial_number(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

ssl_accept_server_cert_signature_algorithm property (OAuth Struct)

The text description of the certificate's signature algorithm.

Syntax

fn ssl_accept_server_cert_signature_algorithm(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_accept_server_cert_store property (OAuth Struct)

The name of the certificate store for the client certificate.

Syntax

fn ssl_accept_server_cert_store(&self ) -> Result<Vec<u8>, CloudKeysError> 
fn set_ssl_accept_server_cert_store(&self, value : Vec<u8>) ->  Option<CloudKeysError> 
fn set_ssl_accept_server_cert_store_ref(&self, value : &[u8]) ->  Option<CloudKeysError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The ssl_accept_server_cert_store_type property denotes the type of the certificate store specified by ssl_accept_server_cert_store. If the store is password-protected, specify the password in ssl_accept_server_cert_store_password.

ssl_accept_server_cert_store is used in conjunction with the ssl_accept_server_cert_subject property to specify client certificates. If ssl_accept_server_cert_store has a value, and ssl_accept_server_cert_subject or ssl_accept_server_cert_encoded is set, a search for a certificate is initiated. Please see the ssl_accept_server_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

Data Type

Vec

ssl_accept_server_cert_store_password property (OAuth Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn ssl_accept_server_cert_store_password(&self ) -> Result<String, CloudKeysError> 
fn set_ssl_accept_server_cert_store_password(&self, value : &str) ->  Option<CloudKeysError> 
fn set_ssl_accept_server_cert_store_password_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

ssl_accept_server_cert_store_type property (OAuth Struct)

The type of certificate store for this certificate.

Syntax

fn ssl_accept_server_cert_store_type(&self ) -> Result<i32, CloudKeysError> 
fn set_ssl_accept_server_cert_store_type(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

Data Type

i32

ssl_accept_server_cert_subject_alt_names property (OAuth Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn ssl_accept_server_cert_subject_alt_names(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

ssl_accept_server_cert_thumbprint_md5 property (OAuth Struct)

The MD5 hash of the certificate.

Syntax

fn ssl_accept_server_cert_thumbprint_md5(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_accept_server_cert_thumbprint_sha1 property (OAuth Struct)

The SHA-1 hash of the certificate.

Syntax

fn ssl_accept_server_cert_thumbprint_sha1(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_accept_server_cert_thumbprint_sha256 property (OAuth Struct)

The SHA-256 hash of the certificate.

Syntax

fn ssl_accept_server_cert_thumbprint_sha256(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_accept_server_cert_usage property (OAuth Struct)

The text description of UsageFlags .

Syntax

fn ssl_accept_server_cert_usage(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The text description of ssl_accept_server_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

ssl_accept_server_cert_usage_flags property (OAuth Struct)

The flags that show intended use for the certificate.

Syntax

fn ssl_accept_server_cert_usage_flags(&self ) -> Result<i32, CloudKeysError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of ssl_accept_server_cert_usage_flags is a combination of the following flags:

Please see the ssl_accept_server_cert_usage property for a text representation of ssl_accept_server_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

ssl_accept_server_cert_version property (OAuth Struct)

The certificate's version number.

Syntax

fn ssl_accept_server_cert_version(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

ssl_accept_server_cert_subject property (OAuth Struct)

The subject of the certificate used for client authentication.

Syntax

fn ssl_accept_server_cert_subject(&self ) -> Result<String, CloudKeysError> 
fn set_ssl_accept_server_cert_subject(&self, value : &str) ->  Option<CloudKeysError> 
fn set_ssl_accept_server_cert_subject_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

ssl_accept_server_cert_encoded property (OAuth Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn ssl_accept_server_cert_encoded(&self ) -> Result<Vec<u8>, CloudKeysError> 
fn set_ssl_accept_server_cert_encoded(&self, value : Vec<u8>) ->  Option<CloudKeysError> 
fn set_ssl_accept_server_cert_encoded_ref(&self, value : &[u8]) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The ssl_accept_server_cert_store and ssl_accept_server_cert_subject properties also may be used to specify a certificate.

When ssl_accept_server_cert_encoded is set, a search is initiated in the current ssl_accept_server_cert_store for the private key of the certificate. If the key is found, ssl_accept_server_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, ssl_accept_server_cert_subject is set to an empty string.

Data Type

Vec

ssl_cert_effective_date property (OAuth Struct)

The date on which this certificate becomes valid.

Syntax

fn ssl_cert_effective_date(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

ssl_cert_expiration_date property (OAuth Struct)

The date on which the certificate expires.

Syntax

fn ssl_cert_expiration_date(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

ssl_cert_extended_key_usage property (OAuth Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn ssl_cert_extended_key_usage(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

ssl_cert_fingerprint property (OAuth Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn ssl_cert_fingerprint(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

ssl_cert_fingerprint_sha1 property (OAuth Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn ssl_cert_fingerprint_sha1(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

ssl_cert_fingerprint_sha256 property (OAuth Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn ssl_cert_fingerprint_sha256(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

ssl_cert_issuer property (OAuth Struct)

The issuer of the certificate.

Syntax

fn ssl_cert_issuer(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

ssl_cert_private_key property (OAuth Struct)

The private key of the certificate (if available).

Syntax

fn ssl_cert_private_key(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The ssl_cert_private_key may be available but not exportable. In this case, ssl_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

ssl_cert_private_key_available property (OAuth Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn ssl_cert_private_key_available(&self ) -> Result<bool, CloudKeysError> 

Default Value

false

Remarks

Whether a ssl_cert_private_key is available for the selected certificate. If ssl_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

ssl_cert_private_key_container property (OAuth Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn ssl_cert_private_key_container(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The name of the ssl_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

ssl_cert_public_key property (OAuth Struct)

The public key of the certificate.

Syntax

fn ssl_cert_public_key(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

ssl_cert_public_key_algorithm property (OAuth Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn ssl_cert_public_key_algorithm(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_cert_public_key_length property (OAuth Struct)

The length of the certificate's public key (in bits).

Syntax

fn ssl_cert_public_key_length(&self ) -> Result<i32, CloudKeysError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

ssl_cert_serial_number property (OAuth Struct)

The serial number of the certificate encoded as a string.

Syntax

fn ssl_cert_serial_number(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

ssl_cert_signature_algorithm property (OAuth Struct)

The text description of the certificate's signature algorithm.

Syntax

fn ssl_cert_signature_algorithm(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_cert_store property (OAuth Struct)

The name of the certificate store for the client certificate.

Syntax

fn ssl_cert_store(&self ) -> Result<Vec<u8>, CloudKeysError> 
fn set_ssl_cert_store(&self, value : Vec<u8>) ->  Option<CloudKeysError> 
fn set_ssl_cert_store_ref(&self, value : &[u8]) ->  Option<CloudKeysError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The ssl_cert_store_type property denotes the type of the certificate store specified by ssl_cert_store. If the store is password-protected, specify the password in ssl_cert_store_password.

ssl_cert_store is used in conjunction with the ssl_cert_subject property to specify client certificates. If ssl_cert_store has a value, and ssl_cert_subject or ssl_cert_encoded is set, a search for a certificate is initiated. Please see the ssl_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

Data Type

Vec

ssl_cert_store_password property (OAuth Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn ssl_cert_store_password(&self ) -> Result<String, CloudKeysError> 
fn set_ssl_cert_store_password(&self, value : &str) ->  Option<CloudKeysError> 
fn set_ssl_cert_store_password_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

ssl_cert_store_type property (OAuth Struct)

The type of certificate store for this certificate.

Syntax

fn ssl_cert_store_type(&self ) -> Result<i32, CloudKeysError> 
fn set_ssl_cert_store_type(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

Data Type

i32

ssl_cert_subject_alt_names property (OAuth Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn ssl_cert_subject_alt_names(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

ssl_cert_thumbprint_md5 property (OAuth Struct)

The MD5 hash of the certificate.

Syntax

fn ssl_cert_thumbprint_md5(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_cert_thumbprint_sha1 property (OAuth Struct)

The SHA-1 hash of the certificate.

Syntax

fn ssl_cert_thumbprint_sha1(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_cert_thumbprint_sha256 property (OAuth Struct)

The SHA-256 hash of the certificate.

Syntax

fn ssl_cert_thumbprint_sha256(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_cert_usage property (OAuth Struct)

The text description of UsageFlags .

Syntax

fn ssl_cert_usage(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The text description of ssl_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

ssl_cert_usage_flags property (OAuth Struct)

The flags that show intended use for the certificate.

Syntax

fn ssl_cert_usage_flags(&self ) -> Result<i32, CloudKeysError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of ssl_cert_usage_flags is a combination of the following flags:

Please see the ssl_cert_usage property for a text representation of ssl_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

ssl_cert_version property (OAuth Struct)

The certificate's version number.

Syntax

fn ssl_cert_version(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

ssl_cert_subject property (OAuth Struct)

The subject of the certificate used for client authentication.

Syntax

fn ssl_cert_subject(&self ) -> Result<String, CloudKeysError> 
fn set_ssl_cert_subject(&self, value : &str) ->  Option<CloudKeysError> 
fn set_ssl_cert_subject_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

ssl_cert_encoded property (OAuth Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn ssl_cert_encoded(&self ) -> Result<Vec<u8>, CloudKeysError> 
fn set_ssl_cert_encoded(&self, value : Vec<u8>) ->  Option<CloudKeysError> 
fn set_ssl_cert_encoded_ref(&self, value : &[u8]) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The ssl_cert_store and ssl_cert_subject properties also may be used to specify a certificate.

When ssl_cert_encoded is set, a search is initiated in the current ssl_cert_store for the private key of the certificate. If the key is found, ssl_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, ssl_cert_subject is set to an empty string.

Data Type

Vec

ssl_provider property (OAuth Struct)

The Secure Sockets Layer/Transport Layer Security (SSL/TLS) implementation to use.

Syntax

fn ssl_provider(&self ) -> Result<i32, CloudKeysError> 
fn set_ssl_provider(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // Automatic
1   // Platform
2   // Internal

Default Value

0

Remarks

This property specifies the SSL/TLS implementation to use. In most cases the default value of 0 (Automatic) is recommended and should not be changed. When set to 0 (Automatic), the struct will select whether to use the platform implementation or the internal implementation depending on the operating system as well as the TLS version being used.

Possible values are as follows:

In most cases using the default value (Automatic) is recommended. The struct will select a provider depending on the current platform.

When Automatic is selected, on Windows, the struct will use the platform implementation. On Linux/macOS, the struct will use the internal implementation. When TLS 1.3 is enabled via SSLEnabledProtocols, the struct will always try and use the platform implementation. If the platform TLS 1.3 implementation is not available, the internal implementation will be used.

Data Type

i32

ssl_server_cert_effective_date property (OAuth Struct)

The date on which this certificate becomes valid.

Syntax

fn ssl_server_cert_effective_date(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

ssl_server_cert_expiration_date property (OAuth Struct)

The date on which the certificate expires.

Syntax

fn ssl_server_cert_expiration_date(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

ssl_server_cert_extended_key_usage property (OAuth Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn ssl_server_cert_extended_key_usage(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

ssl_server_cert_fingerprint property (OAuth Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn ssl_server_cert_fingerprint(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

ssl_server_cert_fingerprint_sha1 property (OAuth Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn ssl_server_cert_fingerprint_sha1(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

ssl_server_cert_fingerprint_sha256 property (OAuth Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn ssl_server_cert_fingerprint_sha256(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

ssl_server_cert_issuer property (OAuth Struct)

The issuer of the certificate.

Syntax

fn ssl_server_cert_issuer(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

ssl_server_cert_private_key property (OAuth Struct)

The private key of the certificate (if available).

Syntax

fn ssl_server_cert_private_key(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The ssl_server_cert_private_key may be available but not exportable. In this case, ssl_server_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

ssl_server_cert_private_key_available property (OAuth Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn ssl_server_cert_private_key_available(&self ) -> Result<bool, CloudKeysError> 

Default Value

false

Remarks

Whether a ssl_server_cert_private_key is available for the selected certificate. If ssl_server_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

ssl_server_cert_private_key_container property (OAuth Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn ssl_server_cert_private_key_container(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The name of the ssl_server_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

ssl_server_cert_public_key property (OAuth Struct)

The public key of the certificate.

Syntax

fn ssl_server_cert_public_key(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

ssl_server_cert_public_key_algorithm property (OAuth Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn ssl_server_cert_public_key_algorithm(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_server_cert_public_key_length property (OAuth Struct)

The length of the certificate's public key (in bits).

Syntax

fn ssl_server_cert_public_key_length(&self ) -> Result<i32, CloudKeysError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

ssl_server_cert_serial_number property (OAuth Struct)

The serial number of the certificate encoded as a string.

Syntax

fn ssl_server_cert_serial_number(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

ssl_server_cert_signature_algorithm property (OAuth Struct)

The text description of the certificate's signature algorithm.

Syntax

fn ssl_server_cert_signature_algorithm(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

ssl_server_cert_store property (OAuth Struct)

The name of the certificate store for the client certificate.

Syntax

fn ssl_server_cert_store(&self ) -> Result<Vec<u8>, CloudKeysError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The ssl_server_cert_store_type property denotes the type of the certificate store specified by ssl_server_cert_store. If the store is password-protected, specify the password in ssl_server_cert_store_password.

ssl_server_cert_store is used in conjunction with the ssl_server_cert_subject property to specify client certificates. If ssl_server_cert_store has a value, and ssl_server_cert_subject or ssl_server_cert_encoded is set, a search for a certificate is initiated. Please see the ssl_server_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

This property is read-only.

Data Type

Vec

ssl_server_cert_store_password property (OAuth Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn ssl_server_cert_store_password(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

This property is read-only.

Data Type

String

ssl_server_cert_store_type property (OAuth Struct)

The type of certificate store for this certificate.

Syntax

fn ssl_server_cert_store_type(&self ) -> Result<i32, CloudKeysError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

This property is read-only.

Data Type

i32

ssl_server_cert_subject_alt_names property (OAuth Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn ssl_server_cert_subject_alt_names(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

ssl_server_cert_thumbprint_md5 property (OAuth Struct)

The MD5 hash of the certificate.

Syntax

fn ssl_server_cert_thumbprint_md5(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_server_cert_thumbprint_sha1 property (OAuth Struct)

The SHA-1 hash of the certificate.

Syntax

fn ssl_server_cert_thumbprint_sha1(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_server_cert_thumbprint_sha256 property (OAuth Struct)

The SHA-256 hash of the certificate.

Syntax

fn ssl_server_cert_thumbprint_sha256(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

ssl_server_cert_usage property (OAuth Struct)

The text description of UsageFlags .

Syntax

fn ssl_server_cert_usage(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The text description of ssl_server_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

ssl_server_cert_usage_flags property (OAuth Struct)

The flags that show intended use for the certificate.

Syntax

fn ssl_server_cert_usage_flags(&self ) -> Result<i32, CloudKeysError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of ssl_server_cert_usage_flags is a combination of the following flags:

Please see the ssl_server_cert_usage property for a text representation of ssl_server_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

ssl_server_cert_version property (OAuth Struct)

The certificate's version number.

Syntax

fn ssl_server_cert_version(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

ssl_server_cert_subject property (OAuth Struct)

The subject of the certificate used for client authentication.

Syntax

fn ssl_server_cert_subject(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

This property is read-only.

Data Type

String

ssl_server_cert_encoded property (OAuth Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn ssl_server_cert_encoded(&self ) -> Result<Vec<u8>, CloudKeysError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The ssl_server_cert_store and ssl_server_cert_subject properties also may be used to specify a certificate.

When ssl_server_cert_encoded is set, a search is initiated in the current ssl_server_cert_store for the private key of the certificate. If the key is found, ssl_server_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, ssl_server_cert_subject is set to an empty string.

This property is read-only.

Data Type

Vec

timeout property (OAuth Struct)

The timeout for the struct.

Syntax

fn timeout(&self ) -> Result<i32, CloudKeysError> 
fn set_timeout(&self, value : i32) ->  Option<CloudKeysError> 

Default Value

60

Remarks

If the timeout property is set to 0, all operations will run uninterrupted until successful completion or an error condition is encountered.

If timeout is set to a positive value, the struct will wait for the operation to complete before returning control.

The struct will use do_events to enter an efficient wait loop during any potential waiting period, making sure that all system events are processed immediately as they arrive. This ensures that the host application does not freeze and remains responsive.

If timeout expires, and the operation is not yet complete, the struct fails with an error.

NOTE: By default, all timeouts are inactivity timeouts, that is, the timeout period is extended by timeout seconds when any amount of data is successfully sent or received.

The default value for the timeout property is 60 seconds.

Data Type

i32

transferred_data property (OAuth Struct)

The contents of the last response from the server.

Syntax

fn transferred_data(&self ) -> Result<Vec<u8>, CloudKeysError> 

Default Value

""

Remarks

This property contains the contents of the last response from the server.

TransferredDataLimit controls the maximum amount of data accumulated in transferred_data (by default, there is no limit).

This property is read-only.

Data Type

Vec

transferred_headers property (OAuth Struct)

The full set of headers as received from the server.

Syntax

fn transferred_headers(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

This property returns the complete set of raw headers as received from the server.

The on_header event shows the individual headers as parsed by the struct.

This property is read-only.

Data Type

String

use_pkce property (OAuth Struct)

Whether Proof Key for Code Exchange (PKCE) should be used.

Syntax

fn use_pkce(&self ) -> Result<bool, CloudKeysError> 
fn set_use_pkce(&self, value : bool) ->  Option<CloudKeysError> 

Default Value

false

Remarks

If specified, Proof Key for Code Exchange (PKCE) defined by RFC 7636 will be used when get_authorization is called. This applies when using the Authorization Code grant_type. The PKCEChallengeEncoding configuration setting can be used to control the code challenge method that will be used. When using the ocpWeb client_profile, the PKCEVerifier configuration setting can be used to get/set the verifier that was used to generate the challenge. See the PKCEVerifier documentation for more information.

Data Type

bool

web_server_port property (OAuth Struct)

The local port on which the embedded web server listens.

Syntax

fn web_server_port(&self ) -> Result<i32, CloudKeysError> 
fn set_web_server_port(&self, value : i32) ->  Option<CloudKeysError> 

Default Value

0

Remarks

This property specifies the port on which the embedded web server listens. Setting this to 0 (default) enables the system to choose a port at random. The chosen port will be returned when this setting is queried after the server has started listening. This is applicable only when using the embedded web server.

Data Type

i32

web_server_ssl_cert_effective_date property (OAuth Struct)

The date on which this certificate becomes valid.

Syntax

fn web_server_ssl_cert_effective_date(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The date on which this certificate becomes valid. Before this date, it is not valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

Data Type

String

web_server_ssl_cert_expiration_date property (OAuth Struct)

The date on which the certificate expires.

Syntax

fn web_server_ssl_cert_expiration_date(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The date on which the certificate expires. After this date, the certificate will no longer be valid. The date is localized to the system's time zone. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

Data Type

String

web_server_ssl_cert_extended_key_usage property (OAuth Struct)

A comma-delimited list of extended key usage identifiers.

Syntax

fn web_server_ssl_cert_extended_key_usage(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

A comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

This property is read-only.

Data Type

String

web_server_ssl_cert_fingerprint property (OAuth Struct)

The hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

fn web_server_ssl_cert_fingerprint(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 16-byte MD5 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

Data Type

String

web_server_ssl_cert_fingerprint_sha1 property (OAuth Struct)

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

fn web_server_ssl_cert_fingerprint_sha1(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 20-byte SHA-1 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

Data Type

String

web_server_ssl_cert_fingerprint_sha256 property (OAuth Struct)

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

fn web_server_ssl_cert_fingerprint_sha256(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The hex-encoded, 32-byte SHA-256 fingerprint of the certificate. This property is primarily used for keys which do not have a corresponding X.509 public certificate, such as PEM keys that only contain a private key. It is commonly used for SSH keys.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

Data Type

String

web_server_ssl_cert_issuer property (OAuth Struct)

The issuer of the certificate.

Syntax

fn web_server_ssl_cert_issuer(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

Data Type

String

web_server_ssl_cert_private_key property (OAuth Struct)

The private key of the certificate (if available).

Syntax

fn web_server_ssl_cert_private_key(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

NOTE: The web_server_ssl_cert_private_key may be available but not exportable. In this case, web_server_ssl_cert_private_key returns an empty string.

This property is read-only.

Data Type

String

web_server_ssl_cert_private_key_available property (OAuth Struct)

Whether a PrivateKey is available for the selected certificate.

Syntax

fn web_server_ssl_cert_private_key_available(&self ) -> Result<bool, CloudKeysError> 

Default Value

false

Remarks

Whether a web_server_ssl_cert_private_key is available for the selected certificate. If web_server_ssl_cert_private_key_available is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

Data Type

bool

web_server_ssl_cert_private_key_container property (OAuth Struct)

The name of the PrivateKey container for the certificate (if available).

Syntax

fn web_server_ssl_cert_private_key_container(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The name of the web_server_ssl_cert_private_key container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

Data Type

String

web_server_ssl_cert_public_key property (OAuth Struct)

The public key of the certificate.

Syntax

fn web_server_ssl_cert_public_key(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

Data Type

String

web_server_ssl_cert_public_key_algorithm property (OAuth Struct)

The textual description of the certificate's public key algorithm.

Syntax

fn web_server_ssl_cert_public_key_algorithm(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

web_server_ssl_cert_public_key_length property (OAuth Struct)

The length of the certificate's public key (in bits).

Syntax

fn web_server_ssl_cert_public_key_length(&self ) -> Result<i32, CloudKeysError> 

Default Value

0

Remarks

The length of the certificate's public key (in bits). Common values are 512, 1024, and 2048.

This property is read-only.

Data Type

i32

web_server_ssl_cert_serial_number property (OAuth Struct)

The serial number of the certificate encoded as a string.

Syntax

fn web_server_ssl_cert_serial_number(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The serial number of the certificate encoded as a string. The number is encoded as a series of hexadecimal digits, with each pair representing a byte of the serial number.

This property is read-only.

Data Type

String

web_server_ssl_cert_signature_algorithm property (OAuth Struct)

The text description of the certificate's signature algorithm.

Syntax

fn web_server_ssl_cert_signature_algorithm(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The text description of the certificate's signature algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_MD5RSA") or an object identifier (OID) string representing the algorithm.

This property is read-only.

Data Type

String

web_server_ssl_cert_store property (OAuth Struct)

The name of the certificate store for the client certificate.

Syntax

fn web_server_ssl_cert_store(&self ) -> Result<Vec<u8>, CloudKeysError> 
fn set_web_server_ssl_cert_store(&self, value : Vec<u8>) ->  Option<CloudKeysError> 
fn set_web_server_ssl_cert_store_ref(&self, value : &[u8]) ->  Option<CloudKeysError> 

Default Value

"MY"

Remarks

The name of the certificate store for the client certificate.

The web_server_ssl_cert_store_type property denotes the type of the certificate store specified by web_server_ssl_cert_store. If the store is password-protected, specify the password in web_server_ssl_cert_store_password.

web_server_ssl_cert_store is used in conjunction with the web_server_ssl_cert_subject property to specify client certificates. If web_server_ssl_cert_store has a value, and web_server_ssl_cert_subject or web_server_ssl_cert_encoded is set, a search for a certificate is initiated. Please see the web_server_ssl_cert_subject property for details.

Designations of certificate stores are platform dependent.

The following designations are the most common User and Machine certificate stores in Windows:

When the certificate store type is cstPFXFile, this property must be set to the name of the file. When the type is cstPFXBlob, the property must be set to the binary contents of a PFX file (i.e., PKCS#12 certificate store).

Data Type

Vec

web_server_ssl_cert_store_password property (OAuth Struct)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

fn web_server_ssl_cert_store_password(&self ) -> Result<String, CloudKeysError> 
fn set_web_server_ssl_cert_store_password(&self, value : &str) ->  Option<CloudKeysError> 
fn set_web_server_ssl_cert_store_password_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Data Type

String

web_server_ssl_cert_store_type property (OAuth Struct)

The type of certificate store for this certificate.

Syntax

fn web_server_ssl_cert_store_type(&self ) -> Result<i32, CloudKeysError> 
fn set_web_server_ssl_cert_store_type(&self, value : i32) ->  Option<CloudKeysError> 

Possible Values

0   // User
1   // Machine
2   // PFXFile
3   // PFXBlob
4   // JKSFile
5   // JKSBlob
6   // PEMKeyFile
7   // PEMKeyBlob
8   // PublicKeyFile
9   // PublicKeyBlob
10   // SSHPublicKeyBlob
11   // P7BFile
12   // P7BBlob
13   // SSHPublicKeyFile
14   // PPKFile
15   // PPKBlob
16   // XMLFile
17   // XMLBlob
18   // JWKFile
19   // JWKBlob
20   // SecurityKey
21   // BCFKSFile
22   // BCFKSBlob
23   // PKCS11
99   // Auto

Default Value

0

Remarks

The type of certificate store for this certificate.

The struct supports both public and private keys in a variety of formats. When the cstAuto value is used, the struct will automatically determine the type. This property can take one of the following values:

Data Type

i32

web_server_ssl_cert_subject_alt_names property (OAuth Struct)

Comma-separated lists of alternative subject names for the certificate.

Syntax

fn web_server_ssl_cert_subject_alt_names(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

Comma-separated lists of alternative subject names for the certificate.

This property is read-only.

Data Type

String

web_server_ssl_cert_thumbprint_md5 property (OAuth Struct)

The MD5 hash of the certificate.

Syntax

fn web_server_ssl_cert_thumbprint_md5(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The MD5 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

web_server_ssl_cert_thumbprint_sha1 property (OAuth Struct)

The SHA-1 hash of the certificate.

Syntax

fn web_server_ssl_cert_thumbprint_sha1(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The SHA-1 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

web_server_ssl_cert_thumbprint_sha256 property (OAuth Struct)

The SHA-256 hash of the certificate.

Syntax

fn web_server_ssl_cert_thumbprint_sha256(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The SHA-256 hash of the certificate. It is primarily used for X.509 certificates. If the hash does not already exist, it is automatically computed.

This property is read-only.

Data Type

String

web_server_ssl_cert_usage property (OAuth Struct)

The text description of UsageFlags .

Syntax

fn web_server_ssl_cert_usage(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The text description of web_server_ssl_cert_usage_flags.

This value will be one or more of the following strings and will be separated by commas:

• Digital Signature
• Non-Repudiation
• Key Encipherment
• Data Encipherment
• Key Agreement
• Certificate Signing
• CRL Signing
• Encipher Only

If the provider is OpenSSL, the value is a comma-separated list of X.509 certificate extension names.

This property is read-only.

Data Type

String

web_server_ssl_cert_usage_flags property (OAuth Struct)

The flags that show intended use for the certificate.

Syntax

fn web_server_ssl_cert_usage_flags(&self ) -> Result<i32, CloudKeysError> 

Default Value

0

Remarks

The flags that show intended use for the certificate. The value of web_server_ssl_cert_usage_flags is a combination of the following flags:

Please see the web_server_ssl_cert_usage property for a text representation of web_server_ssl_cert_usage_flags.

This functionality currently is not available when the provider is OpenSSL.

This property is read-only.

Data Type

i32

web_server_ssl_cert_version property (OAuth Struct)

The certificate's version number.

Syntax

fn web_server_ssl_cert_version(&self ) -> Result<String, CloudKeysError> 

Default Value

""

Remarks

The certificate's version number. The possible values are the strings "V1", "V2", and "V3".

This property is read-only.

Data Type

String

web_server_ssl_cert_subject property (OAuth Struct)

The subject of the certificate used for client authentication.

Syntax

fn web_server_ssl_cert_subject(&self ) -> Result<String, CloudKeysError> 
fn set_web_server_ssl_cert_subject(&self, value : &str) ->  Option<CloudKeysError> 
fn set_web_server_ssl_cert_subject_ref(&self, value : &String) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The subject of the certificate used for client authentication.

This property must be set after all other certificate properties are set. When this property is set, a search is performed in the current certificate store to locate a certificate with a matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma-separated list of distinguished name fields and values. For instance, "CN=www.server.com, OU=test, C=US, E=example@email.com". Common fields and their meanings are as follows:

If a field value contains a comma, it must be quoted.

Data Type

String

web_server_ssl_cert_encoded property (OAuth Struct)

The certificate (PEM/Base64 encoded).

Syntax

fn web_server_ssl_cert_encoded(&self ) -> Result<Vec<u8>, CloudKeysError> 
fn set_web_server_ssl_cert_encoded(&self, value : Vec<u8>) ->  Option<CloudKeysError> 
fn set_web_server_ssl_cert_encoded_ref(&self, value : &[u8]) ->  Option<CloudKeysError> 

Default Value

""

Remarks

The certificate (PEM/Base64 encoded). This property is used to assign a specific certificate. The web_server_ssl_cert_store and web_server_ssl_cert_subject properties also may be used to specify a certificate.

When web_server_ssl_cert_encoded is set, a search is initiated in the current web_server_ssl_cert_store for the private key of the certificate. If the key is found, web_server_ssl_cert_subject is updated to reflect the full subject of the selected certificate; otherwise, web_server_ssl_cert_subject is set to an empty string.

Data Type

Vec

web_server_ssl_enabled property (OAuth Struct)

Whether the web server requires Secure Sockets Layer (SSL) connections.

Syntax

fn web_server_ssl_enabled(&self ) -> Result<bool, CloudKeysError> 
fn set_web_server_ssl_enabled(&self, value : bool) ->  Option<CloudKeysError> 

Default Value

false

Remarks

This setting specifies whether the embedded web server uses a Secure Sockets Layer (SSL). If set to True, web_server_ssl_cert is required and the server will accept only SSL connections. If set to False, only plaintext connects are supported.

Data Type

bool

add_cookie method (OAuth Struct)

Adds a cookie and the corresponding value to the outgoing request headers.

Syntax

fn add_cookie(&self, cookie_name : &str, cookie_value : &str) -> Result<(), CloudKeysError>

Remarks

This method adds a cookie and the corresponding value to the outgoing request headers. Please refer to the cookies property for more information on cookies and how they are managed.

add_param method (OAuth Struct)

Adds a name-value pair to the query string parameters of the outgoing request.

Syntax

fn add_param(&self, param_name : &str, param_value : &str) -> Result<(), CloudKeysError>

Remarks

This method can be used to add query string parameters to the outgoing request. One common use for this method would be to add the state parameter to the request, which can be used when the client_profile is ocpWeb to add user-defined data. The authorization server will include the state parameter in the response and will be available in the post back to your server, which will allow you to maintain state in your application.

config method (OAuth Struct)

Sets or retrieves a configuration setting.

Syntax

fn config(&self, configuration_string : &str) ->  Result<String, CloudKeysError>

Remarks

config is a generic method available in every struct. It is used to set and retrieve configuration settings for the struct.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the struct, access to these internal properties is provided through the config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

do_events method (OAuth Struct)

This method processes events from the internal message queue.

Syntax

fn do_events(&self) -> Result<(), CloudKeysError>

Remarks

When do_events is called, the struct processes any available events. If no events are available, it waits for a preset period of time, and then returns.

get_authorization method (OAuth Struct)

Gets the authorization string required to access the protected resource.

Syntax

fn get_authorization(&self) ->  Result<String, CloudKeysError>

Remarks

This method performs several operations automatically depending on the value of client_profile. Please see the introduction section for the OAuth struct for a detailed overview of the typical scenarios.

After authorization is completed, this method will return the authorization string, which can be passed directly to the authorization property of any other component. This can also be passed as the value of the HTTP authorization header to other implementations that access the protected resource as well.

The access_token property should be cleared before calling this method.

get_authorization_url method (OAuth Struct)

Builds and returns the URL to which the user should be redirected for authorization.

Syntax

fn get_authorization_url(&self) ->  Result<String, CloudKeysError>

Remarks

When this method is called, the struct will return the URL used for authorization. The struct will not make any connections, but instead it will return the URL to you so that you may redirect the user to this location. This is useful when client_profile is set to ocpWeb. Before calling this method, set the following:

• client_id
• client_secret
• return_url
• authorization_scope (optional)

get_param method (OAuth Struct)

Gets a specific parameter from a query string.

Syntax

fn get_param(&self, param_name : &str) ->  Result<String, CloudKeysError>

Remarks

This method can be used to get a specific parameter from a query string.

For example, when using the ocpApplication profile, this method can be used in the on_return_url event to query the parameters that are returned from the authorization server. Then, it can be called after get_authorization completes to query the parameters that the token server responded with.

string authorizationString = oauth.GetAuthorization(); string stateValue = oauth.GetParam("state");

interrupt method (OAuth Struct)

This method interrupts the current method.

Syntax

fn interrupt(&self) -> Result<(), CloudKeysError>

Remarks

If there is no method in progress, interrupt simply returns, doing nothing.

reset method (OAuth Struct)

This method will reset the struct.

Syntax

fn reset(&self) -> Result<(), CloudKeysError>

Remarks

This method will reset the struct's properties to their default values.

start_web_server method (OAuth Struct)

Starts the embedded web server.

Syntax

fn start_web_server(&self) -> Result<(), CloudKeysError>

Remarks

This method starts the embedded web server. This method can be used to manually start the embedded web server. Under normal circumstances, this is not needed as the component will automatically start and stop the web server when get_authorization is called. You may decide, however, to start the web server manually before calling get_authorization. When called, this method will also populate return_url with the address of the embedded server.

stop_web_server method (OAuth Struct)

Stops the embedded web server.

Syntax

fn stop_web_server(&self) -> Result<(), CloudKeysError>

Remarks

This method stops the embedded web server. Under normal circumstances, the web server will be stopped automatically during the authorization process when get_authorization is called.

on_connected event (OAuth Struct)

Fired immediately after a connection completes (or fails).

Syntax

// OAuthConnectedEventArgs carries the OAuth Connected event's parameters.
pub struct OAuthConnectedEventArgs {
  fn status_code(&self) -> i32
  fn description(&self) -> &String
}

// OAuthConnectedEvent defines the signature of the OAuth Connected event's handler function.
pub trait OAuthConnectedEvent {
  fn on_connected(&self, sender : OAuth, e : &mut OAuthConnectedEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_connected(&self) -> &'a dyn OAuthConnectedEvent;
  pub fn set_on_connected(&mut self, value : &'a dyn OAuthConnectedEvent);
  ...
}

Remarks

If the connection is made normally, status_code is 0 and description is "OK".

If the connection fails, status_code has the error code returned by the Transmission Control Protocol (TCP)/IP stack. description contains a description of this code. The value of status_code is equal to the value of the error.

Please refer to the Error Codes section for more information.

on_connection_status event (OAuth Struct)

Fired to indicate changes in the connection state.

Syntax

// OAuthConnectionStatusEventArgs carries the OAuth ConnectionStatus event's parameters.
pub struct OAuthConnectionStatusEventArgs {
  fn connection_event(&self) -> &String
  fn status_code(&self) -> i32
  fn description(&self) -> &String
}

// OAuthConnectionStatusEvent defines the signature of the OAuth ConnectionStatus event's handler function.
pub trait OAuthConnectionStatusEvent {
  fn on_connection_status(&self, sender : OAuth, e : &mut OAuthConnectionStatusEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_connection_status(&self) -> &'a dyn OAuthConnectionStatusEvent;
  pub fn set_on_connection_status(&mut self, value : &'a dyn OAuthConnectionStatusEvent);
  ...
}

Remarks

This event is fired when the connection state changes: for example, completion of a firewall or proxy connection or completion of a security handshake.

The connection_event parameter indicates the type of connection event. Values may include the following:

on_disconnected event (OAuth Struct)

Fired when a connection is closed.

Syntax

// OAuthDisconnectedEventArgs carries the OAuth Disconnected event's parameters.
pub struct OAuthDisconnectedEventArgs {
  fn status_code(&self) -> i32
  fn description(&self) -> &String
}

// OAuthDisconnectedEvent defines the signature of the OAuth Disconnected event's handler function.
pub trait OAuthDisconnectedEvent {
  fn on_disconnected(&self, sender : OAuth, e : &mut OAuthDisconnectedEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_disconnected(&self) -> &'a dyn OAuthDisconnectedEvent;
  pub fn set_on_disconnected(&mut self, value : &'a dyn OAuthDisconnectedEvent);
  ...
}

Remarks

If the connection is broken normally, status_code is 0 and description is "OK".

If the connection is broken for any other reason, status_code has the error code returned by the Transmission Control Protocol (TCP/IP) subsystem. description contains a description of this code. The value of status_code is equal to the value of the TCP/IP error.

Please refer to the Error Codes section for more information.

on_end_transfer event (OAuth Struct)

Fired when a document finishes transferring.

Syntax

// OAuthEndTransferEventArgs carries the OAuth EndTransfer event's parameters.
pub struct OAuthEndTransferEventArgs {
  fn direction(&self) -> i32
}

// OAuthEndTransferEvent defines the signature of the OAuth EndTransfer event's handler function.
pub trait OAuthEndTransferEvent {
  fn on_end_transfer(&self, sender : OAuth, e : &mut OAuthEndTransferEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_end_transfer(&self) -> &'a dyn OAuthEndTransferEvent;
  pub fn set_on_end_transfer(&mut self, value : &'a dyn OAuthEndTransferEvent);
  ...
}

Remarks

This event is fired first when the client finishes sending data to the server (in a POST or PUT request) and then when the document text finishes transferring from the server to the local host.

The Direction parameter shows whether the client (0) or the server (1) is sending the data.

on_error event (OAuth Struct)

Fired when information is available about errors during data delivery.

Syntax

// OAuthErrorEventArgs carries the OAuth Error event's parameters.
pub struct OAuthErrorEventArgs {
  fn error_code(&self) -> i32
  fn description(&self) -> &String
}

// OAuthErrorEvent defines the signature of the OAuth Error event's handler function.
pub trait OAuthErrorEvent {
  fn on_error(&self, sender : OAuth, e : &mut OAuthErrorEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_error(&self) -> &'a dyn OAuthErrorEvent;
  pub fn set_on_error(&mut self, value : &'a dyn OAuthErrorEvent);
  ...
}

Remarks

The on_error event is fired in case of exceptional conditions during message processing. Normally the struct fails with an error.

The error_code parameter contains an error code, and the description parameter contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to the Error Codes section.

on_header event (OAuth Struct)

Fired every time a header line comes in.

Syntax

// OAuthHeaderEventArgs carries the OAuth Header event's parameters.
pub struct OAuthHeaderEventArgs {
  fn field(&self) -> &String
  fn value(&self) -> &String
}

// OAuthHeaderEvent defines the signature of the OAuth Header event's handler function.
pub trait OAuthHeaderEvent {
  fn on_header(&self, sender : OAuth, e : &mut OAuthHeaderEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_header(&self) -> &'a dyn OAuthHeaderEvent;
  pub fn set_on_header(&mut self, value : &'a dyn OAuthHeaderEvent);
  ...
}

Remarks

The field parameter contains the name of the HTTP header (which is the same as it is delivered). The value parameter contains the header contents.

If the header line being retrieved is a continuation header line, then the field parameter contains "" (empty string).

on_launch_browser event (OAuth Struct)

Fires before launching a browser with the authorization URL.

Syntax

// OAuthLaunchBrowserEventArgs carries the OAuth LaunchBrowser event's parameters.
pub struct OAuthLaunchBrowserEventArgs {
  fn url(&self) -> &String
  fn set_url(&self, value : &str)
  fn set_url_ref(&self, value : &String)
  fn command(&self) -> &String
  fn set_command(&self, value : &str)
  fn set_command_ref(&self, value : &String)
}

// OAuthLaunchBrowserEvent defines the signature of the OAuth LaunchBrowser event's handler function.
pub trait OAuthLaunchBrowserEvent {
  fn on_launch_browser(&self, sender : OAuth, e : &mut OAuthLaunchBrowserEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_launch_browser(&self) -> &'a dyn OAuthLaunchBrowserEvent;
  pub fn set_on_launch_browser(&mut self, value : &'a dyn OAuthLaunchBrowserEvent);
  ...
}

Remarks

When the client_profile property is set to ocpApplication and get_authorization is called, the struct will fire this event with the command, which will be executed by the struct. The url parameter will be the authorization URL that the user will be directed to authenticate.

Within this event, you may override the current value of either command or url and provide your own value. If command is set to an empty string, the struct will not attempt to launch the browser and instead you will be responsible for directing the user to the authorization URL specified by the URL parameter. If command is not empty, the URL will be appended to the end.

In Windows, ShellExecute is used to execute command, which limits the verbs available for use in command to:

• edit
• explore
• find
• open
• print

on_log event (OAuth Struct)

Fired once for each log message.

Syntax

// OAuthLogEventArgs carries the OAuth Log event's parameters.
pub struct OAuthLogEventArgs {
  fn log_level(&self) -> i32
  fn message(&self) -> &String
  fn log_type(&self) -> &String
}

// OAuthLogEvent defines the signature of the OAuth Log event's handler function.
pub trait OAuthLogEvent {
  fn on_log(&self, sender : OAuth, e : &mut OAuthLogEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_log(&self) -> &'a dyn OAuthLogEvent;
  pub fn set_on_log(&mut self, value : &'a dyn OAuthLogEvent);
  ...
}

Remarks

This event is fired once for each log message generated by the struct. The verbosity is controlled by the LogLevel setting.

log_level indicates the level of message. Possible values are as follows:

The value 1 (Info) logs basic information, including the URL, HTTP version, and status details.

The value 2 (Verbose) logs additional information about the request and response.

The value 3 (Debug) logs the headers and body for both the request and response, as well as additional debug information (if any).

message is the log entry.

log_type identifies the type of log entry. Possible values are as follows:

• "Info"
• "RequestHeaders"
• "ResponseHeaders"
• "RequestBody"
• "ResponseBody"
• "ProxyRequest"
• "ProxyResponse"
• "FirewallRequest"
• "FirewallResponse"

on_redirect event (OAuth Struct)

Fired when a redirection is received from the server.

Syntax

// OAuthRedirectEventArgs carries the OAuth Redirect event's parameters.
pub struct OAuthRedirectEventArgs {
  fn location(&self) -> &String
  fn accept(&self) -> bool
  fn set_accept(&self, value : bool)
}

// OAuthRedirectEvent defines the signature of the OAuth Redirect event's handler function.
pub trait OAuthRedirectEvent {
  fn on_redirect(&self, sender : OAuth, e : &mut OAuthRedirectEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_redirect(&self) -> &'a dyn OAuthRedirectEvent;
  pub fn set_on_redirect(&mut self, value : &'a dyn OAuthRedirectEvent);
  ...
}

Remarks

This event is fired in cases in which the client can decide whether or not to continue with the redirection process. The accept parameter is always True by default, but if you do not want to follow the redirection, accept may be set to False, in which case the struct fails with an error. location is the location to which the client is being redirected. Further control over redirection is provided in the follow_redirects property.

on_return_url event (OAuth Struct)

Fired when the user is redirected to the embedded web server.

Syntax

// OAuthReturnURLEventArgs carries the OAuth ReturnURL event's parameters.
pub struct OAuthReturnURLEventArgs {
  fn url_path(&self) -> &String
  fn query_string(&self) -> &String
  fn response_headers(&self) -> &String
  fn set_response_headers(&self, value : &str)
  fn set_response_headers_ref(&self, value : &String)
  fn response_body(&self) -> &String
  fn set_response_body(&self, value : &str)
  fn set_response_body_ref(&self, value : &String)
}

// OAuthReturnURLEvent defines the signature of the OAuth ReturnURL event's handler function.
pub trait OAuthReturnURLEvent {
  fn on_return_url(&self, sender : OAuth, e : &mut OAuthReturnURLEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_return_url(&self) -> &'a dyn OAuthReturnURLEvent;
  pub fn set_on_return_url(&mut self, value : &'a dyn OAuthReturnURLEvent);
  ...
}

Remarks

When client_profile is set to ocpApplication and the embedded web server is used (default), this event will fire when the user is redirected from the authorization server back to the local embedded web server. The event provides an opportunity to set the response_headers and response_body and to provide a custom response that the user will see in their browser.

url_path and query_string are informational parameters that show the values sent by the authorization server.

Additionally, the params properties will be populated. This allows the get_param method to be used to get a specific parameter returned from the authorization server when used within this event.

on_set_cookie event (OAuth Struct)

Fired for every cookie set by the server.

Syntax

// OAuthSetCookieEventArgs carries the OAuth SetCookie event's parameters.
pub struct OAuthSetCookieEventArgs {
  fn name(&self) -> &String
  fn value(&self) -> &String
  fn expires(&self) -> &String
  fn domain(&self) -> &String
  fn path(&self) -> &String
  fn secure(&self) -> bool
}

// OAuthSetCookieEvent defines the signature of the OAuth SetCookie event's handler function.
pub trait OAuthSetCookieEvent {
  fn on_set_cookie(&self, sender : OAuth, e : &mut OAuthSetCookieEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_set_cookie(&self) -> &'a dyn OAuthSetCookieEvent;
  pub fn set_on_set_cookie(&mut self, value : &'a dyn OAuthSetCookieEvent);
  ...
}

Remarks

This event is fired for every Set-Cookie: header received from the HTTP server.

The name parameter contains the name of the cookie, with the corresponding value supplied in the value parameter.

The expires parameter contains an expiration time for the cookie (if provided by the server). The time format used is "Weekday, DD-Mon-YY HH:MM:SS GMT". If the server does not provide an expiration time, the expires parameter will be an empty string. In this case, the convention is to drop the cookie at the end of the session.

The domain parameter contains a domain name to limit the cookie to (if provided by the server). If the server does not provide a domain name, the domain parameter will be an empty string. The convention in this case is to use the server specified in the URL (url_server) as the cookie domain.

The path parameter contains a path name to limit the cookie to (if provided by the server). If the server does not provide a cookie path, the path parameter will be an empty string. The convention in this case is to use the path specified in the URL (url_path) as the cookie path.

The secure parameter specifies whether the cookie is secure. If the value of this parameter is True, the cookie value must be submitted only through a secure (HTTPS) connection.

on_ssl_server_authentication event (OAuth Struct)

Fired after the server presents its certificate to the client.

Syntax

// OAuthSSLServerAuthenticationEventArgs carries the OAuth SSLServerAuthentication event's parameters.
pub struct OAuthSSLServerAuthenticationEventArgs {
  fn cert_encoded(&self) -> &[u8]
  fn cert_subject(&self) -> &String
  fn cert_issuer(&self) -> &String
  fn status(&self) -> &String
  fn accept(&self) -> bool
  fn set_accept(&self, value : bool)
}

// OAuthSSLServerAuthenticationEvent defines the signature of the OAuth SSLServerAuthentication event's handler function.
pub trait OAuthSSLServerAuthenticationEvent {
  fn on_ssl_server_authentication(&self, sender : OAuth, e : &mut OAuthSSLServerAuthenticationEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_ssl_server_authentication(&self) -> &'a dyn OAuthSSLServerAuthenticationEvent;
  pub fn set_on_ssl_server_authentication(&mut self, value : &'a dyn OAuthSSLServerAuthenticationEvent);
  ...
}

Remarks

During this event, the client can decide whether or not to continue with the connection process. The accept parameter is a recommendation on whether to continue or close the connection. This is just a suggestion: application software must use its own logic to determine whether or not to continue.

When accept is False, status shows why the verification failed (otherwise, status contains the string OK). If it is decided to continue, you can override and accept the certificate by setting the accept parameter to True.

on_ssl_status event (OAuth Struct)

Fired when secure connection progress messages are available.

Syntax

// OAuthSSLStatusEventArgs carries the OAuth SSLStatus event's parameters.
pub struct OAuthSSLStatusEventArgs {
  fn message(&self) -> &String
}

// OAuthSSLStatusEvent defines the signature of the OAuth SSLStatus event's handler function.
pub trait OAuthSSLStatusEvent {
  fn on_ssl_status(&self, sender : OAuth, e : &mut OAuthSSLStatusEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_ssl_status(&self) -> &'a dyn OAuthSSLStatusEvent;
  pub fn set_on_ssl_status(&mut self, value : &'a dyn OAuthSSLStatusEvent);
  ...
}

Remarks

The event is fired for informational and logging purposes only. This event tracks the progress of the connection.

on_start_transfer event (OAuth Struct)

Fired when a document starts transferring (after the headers).

Syntax

// OAuthStartTransferEventArgs carries the OAuth StartTransfer event's parameters.
pub struct OAuthStartTransferEventArgs {
  fn direction(&self) -> i32
}

// OAuthStartTransferEvent defines the signature of the OAuth StartTransfer event's handler function.
pub trait OAuthStartTransferEvent {
  fn on_start_transfer(&self, sender : OAuth, e : &mut OAuthStartTransferEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_start_transfer(&self) -> &'a dyn OAuthStartTransferEvent;
  pub fn set_on_start_transfer(&mut self, value : &'a dyn OAuthStartTransferEvent);
  ...
}

Remarks

This event is fired first when the client starts sending data to the server (in a POST or PUT request) and then when the document text starts transferring from the server to the local host.

The Direction parameter shows whether the client (0) or the server (1) is sending the data.

on_status event (OAuth Struct)

Fired when the HTTP status line is received from the server.

Syntax

// OAuthStatusEventArgs carries the OAuth Status event's parameters.
pub struct OAuthStatusEventArgs {
  fn http_version(&self) -> &String
  fn status_code(&self) -> i32
  fn description(&self) -> &String
}

// OAuthStatusEvent defines the signature of the OAuth Status event's handler function.
pub trait OAuthStatusEvent {
  fn on_status(&self, sender : OAuth, e : &mut OAuthStatusEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_status(&self) -> &'a dyn OAuthStatusEvent;
  pub fn set_on_status(&mut self, value : &'a dyn OAuthStatusEvent);
  ...
}

Remarks

http_version is a string containing the HTTP version string as returned from the server (e.g., "1.1").

status_code contains the HTTP status code (e.g., 200), and description the associated message returned by the server (e.g., "OK").

on_transfer event (OAuth Struct)

Fired while a document transfers (delivers document).

Syntax

// OAuthTransferEventArgs carries the OAuth Transfer event's parameters.
pub struct OAuthTransferEventArgs {
  fn direction(&self) -> i32
  fn bytes_transferred(&self) -> i64
  fn percent_done(&self) -> i32
  fn text(&self) -> &[u8]
}

// OAuthTransferEvent defines the signature of the OAuth Transfer event's handler function.
pub trait OAuthTransferEvent {
  fn on_transfer(&self, sender : OAuth, e : &mut OAuthTransferEventArgs);
}

impl <'a> OAuth<'a> {
  pub fn on_transfer(&self) -> &'a dyn OAuthTransferEvent;
  pub fn set_on_transfer(&mut self, value : &'a dyn OAuthTransferEvent);
  ...
}

Remarks

The text parameter contains the portion of the document text being received. It is empty if data are being posted to the server.

The bytes_transferred parameter contains the number of bytes transferred in this direction since the beginning of the document text (excluding HTTP response headers).

The Direction parameter shows whether the client (0) or the server (1) is sending the data.

The PercentDone parameter shows the progress of the transfer in the corresponding direction. If PercentDone can not be calculated the value will be -1.

NOTE: Events are not re-entrant. Performing time-consuming operations within this event will prevent it from firing again in a timely manner and may affect overall performance.

Config Settings (OAuth Struct)

OAuth Config Settings

WebServer Config Settings

HTTP Config Settings

TCPClient Config Settings

SSL Config Settings

-----BEGIN CERTIFICATE-----
MIIEKzCCAxOgAwIBAgIRANTET4LIkxdH6P+CFIiHvTowDQYJKoZIhvcNAQELBQAw
... Intermediate Cert ...
eWHV5OW1K53o/atv59sOiW5K3crjFhsBOd5Q+cJJnU+SWinPKtANXMht+EDvYY2w
F0I1XhM+pKj7FjDr+XNj
-----END CERTIFICATE-----
\r \n
-----BEGIN CERTIFICATE-----
MIIEFjCCAv6gAwIBAgIQetu1SMxpnENAnnOz1P+PtTANBgkqhkiG9w0BAQUFADBp
... Root Cert ...
d8q23djXZbVYiIfE9ebr4g3152BlVCHZ2GyPdjhIuLeH21VbT/dyEHHA
-----END CERTIFICATE-----

-----BEGIN CERTIFICATE-----
MIIEKzCCAxOgAwIBAgIRANTET4LIkxdH6P+CFIiHvTowDQYJKoZIhvcNAQELBQAw
... Intermediate Cert ...
eWHV5OW1K53o/atv59sOiW5K3crjFhsBOd5Q+cJJnU+SWinPKtANXMht+EDvYY2w
F0I1XhM+pKj7FjDr+XNj
-----END CERTIFICATE-----
\r \n
-----BEGIN CERTIFICATE-----
MIIEFjCCAv6gAwIBAgIQetu1SMxpnENAnnOz1P+PtTANBgkqhkiG9w0BAQUFADBp
... Root Cert ...
d8q23djXZbVYiIfE9ebr4g3152BlVCHZ2GyPdjhIuLeH21VbT/dyEHHA
-----END CERTIFICATE-----

-----BEGIN CERTIFICATE-----
MIIEKzCCAxOgAwIBAgIRANTET4LIkxdH6P+CFIiHvTowDQYJKoZIhvcNAQELBQAw
... Intermediate Cert...
eWHV5OW1K53o/atv59sOiW5K3crjFhsBOd5Q+cJJnU+SWinPKtANXMht+EDvYY2w
F0I1XhM+pKj7FjDr+XNj
-----END CERTIFICATE-----
\r \n
-----BEGIN CERTIFICATE-----
MIIEFjCCAv6gAwIBAgIQetu1SMxpnENAnnOz1P+PtTANBgkqhkiG9w0BAQUFADBp
... Root Cert...
d8q23djXZbVYiIfE9ebr4g3152BlVCHZ2GyPdjhIuLeH21VbT/dyEHHA
-----END CERTIFICATE-----

Socket Config Settings

Base Config Settings