Skip to main content
Gateway users are credentials for the Cognite PostgreSQL gateway. They connect to CDF through the PostgreSQL protocol. You can create, list, update, and delete gateway users, each with their own access permissions.

​
What gateway users are

A gateway user is an identity that is authorized to connect to CDF through the PostgreSQL protocol. Each user has credentials, such as a username and password, that clients use to establish a connection. The user’s permissions determine which CDF data they can access and what operations they can perform.

​
Use cases

  • Ingestion: Connect ETL tools that write to PostgreSQL, such as Azure Data Factory, and ingest data into CDF.
  • SQL tools: Connect from tools like DBeaver, pgAdmin, or psql to verify ingested data with a simple filtered read. Don’t use these connections for business intelligence or aggregation-heavy queries. See Limitations.
  • Custom applications: Build applications that use standard PostgreSQL drivers to ingest data into CDF.
Gateway users are separate from CDF API keys and OIDC login. Manage them independently for PostgreSQL-specific access.

​
Managing gateway users

You create gateway users by using the API and assign appropriate permissions. Each user can be configured with access to specific data sets, resource types, or other scopes. You can update credentials or revoke access by deleting the user when it is no longer needed.
Last modified on September 18, 2026