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:
ClientServer- 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; |