Skip to content

Edit Credentials

The "Edit Credentials" administrative task facilitates the definition of authentication details for external systems that Emakin interacts with. These credentials are automatically injected by Emakin into relevant process calls, such as web service requests or database connections. Importantly, these credentials are only transmitted to the specific systems that require them, identified by the URL address for web service calls and the connection name for database calls.

URL Credentials

This section manages credentials that are applied when Emakin performs a web request. HTTP-based SOAP and REST requests are automatically authenticated if the requested URL matches any of the entries in the configured lists.

User Password Credentials

This type of credential is used for basic authentication where a username and password are required.

  • Address: The integration URL to which these credentials apply.
  • User Name: The username required for authentication.
  • Password: The password associated with the username for authentication.

Service Credentials

This type of credential is used for service-to-service authentication, often involving API keys or more complex configurations.

  • Name: A descriptive name for the service requiring authentication.
  • Address: The integration URL for the service.
  • API Key: The API key required for authentication with the service.
  • Type: Specifies the type of service interaction.
    • Client: Typically for public or browser-based applications.
    • Server: Typically for server-side applications or confidential clients.
  • Configuration: Additional configuration information specific to the service's authentication mechanism.

External Database Credentials

This section defines connection credentials for external databases that Emakin will interact with. Refer to Database.ExecuteQuery for usage with scripting.

  • Name: A unique name for the external database connection.
  • Provider: The type of external database system (e.g., Postgres, MS SQL Server, Oracle).

  • Connection String: The full connection string required to establish a connection to the database.

    Examples:

    Provider Connection String
    Postgres Host=myserver;Database=mydatabase;Username=myUsername;Password=myPassword
    MS SQL Server (Default Instance) Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;
    MS SQL Server (Named Instance) Server=myServerName\\myInstanceName;Database=myDataBase;User Id=myUsername;Password=myPassword;
    Oracle (with tnsnames.ora) Data Source=MyOracleDB;User Id=myUsername;Password=myPassword;Integrated Security=no;
    Oracle (without tnsnames.ora) SERVER=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=MyHost)(PORT=MyPort))(CONNECT_DATA=(SERVICE_NAME=MyOracleSID)));uid=myUsername;pwd=myPassword;

  • Description: Optional field for additional descriptive information about the database connection.