Skip to content

Edit Credentials

Manage these entries in Edit Domain → Web and Database Credentials. The separate Edit Credentials process is no longer offered for new work; existing work items provide a link to Edit Domain. This reference remains at its existing address for links from other guides.

These credentials authenticate outgoing web-service requests and external database connections. URL credentials are selected by their matching target address; external database credentials identify named connections.

Opening Edit Domain requires domain_write or domain_cred. Users with domain_write can create, change, and delete definitions and enter known secrets. Users with only domain_cred can enter or replace passwords, API keys, and certificate configuration on existing records, while definition fields remain read-only. Neither role can read stored secrets from the editor. See Permissions and Credential Handling for the administrator handoff and blank-field behavior.

When to Use This Page

Use the Web and Database Credentials section when a process or integration must authenticate against:

  • an HTTP endpoint
  • an external service using an API key or service-style credential
  • an external database

User Password Credentials

URL credentials apply to outgoing web requests. HTTP-based SOAP and REST requests are authenticated automatically when their target URL matches a configured entry.

This is the main domain-administration page for credentials used by outgoing SOAP or REST integrations designed in the Developer Guide.

Use this credential type for username/password authentication.

  • Address: target integration URL
  • User Name: user name for authentication
  • Password: password for authentication

Service Credentials

Service credentials support service-to-service access patterns.

  • Name: descriptive name
  • Address: target integration URL
  • API Key: API key or equivalent credential
  • Type:
  • Client
  • Server
  • Configuration: secret-bearing service configuration, such as certificate material; stored content is not returned to the editor

External Database Credentials

External database credentials define named connections that Emakin can use for database access, including scripted Database.ExecuteQuery calls.

Supported fields:

  • Name
  • Provider
  • Connection String: connection settings without the password
  • Password: enter or replace the database password separately
  • Description

Passwords embedded in existing connection strings are omitted from the displayed definition. A credential-only administrator can replace the password without changing the provider, address, or other connection settings.

Connection String Examples

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