The updateOIDCIdentityProvider() GraphQL mutation is used to change an OIDC identity provider in LogScale.

For more information on OpenID Connect, see the Authenticating with OpenID Connect documentation page. You may also want to look at Authentication & Identity Providers for related information.

Syntax

Below is the syntax for the updateOIDCIdentityProvider() mutation field:

graphql
updateOIDCIdentityProvider(
     input: UpdateOidcConfigurationInput!
   ): OidcIdentityProvider!

Given Datatypes

For the given datatype, UpdateOidcConfigurationInput, there are several parameters that may be given. Below is a list of them along with their datatypes and a description of each:

Table: UpdateOidcConfigurationInput

ParameterTypeRequiredDefaultDescription
Some arguments may be required, as indicated in the Required column. For some fields, this column indicates that a result will always be returned for this column.
Table last updated: Sep 23, 2024
authorizationEndpointstring  A URL to the endpoint a user should be redirected to when authorizing. Required for clients.
clientIdstringyes The unique identifier for the client.
clientSecretstringyes The client's password or passphrase for the identity provider.
defaultIdpbooleanyes The default identity provider.
domains[string]yes The domains associated with the OIDC configuration.
enableDebugbooleanyes Whether to enable debugging.
federatedIdpstring  The Federated IdP.
groupsClaimstring  The name of the claim to interpret as the groups in LogScale. The value in the claim must be an array of strings. Optional. Defaults to humio-groups.
humioOwnedbooleanyes Whether authentication is managed by LogScale.
idstringyes The unique identifier for the OpenId Connect (OIDC) configurtion to update.
issuerstringyes The issuer of the OIDC.
JWKSEndpointstring  A URL to the JWKS endpoint for retrieving keys for validating tokens. Required.
lazyCreateUsersbooleanyes Whether to wait to create users until necessary.
namestringyes The name of the OIDC identify provider.
registrationEndpointstring  To use OIDC as a client, PUBLIC_URL must be set, LogScale must be registered as a client with your OpenID provider, and the provider must allow %PUBLIC_URL%/auth/oidc as a valid redirect endpoint for the client.
scopeClaimstring  The claim or user attributes for the scope.
scopes[string]yes Comma-separated list of scopes to add in addition to the default requested scopes (openid, email, and profile).
tokenEndpointstring  A URL to the token endpoint used to exchange a authentication code to an access token. Required for clients.
tokenEndpointAuthMethodstringyes The authentication method used to authenticate LogScale against the token endpoint. Can either be client_secret_basic or client_secret_post for placing the client id and secret in either basic auth or post data, respectively. Defaults to client_secret_basic, or client_secret_post if client_secret_basic is not supported as per the discovery endpoint.
userClaimstringyes The name of the claim to interpret as username in LogScale. The value in the claim must be a string. Defaults to humio-user. Can be set to email if using emails as usernames.
userInfoEndpointstring  A URL to the user info endpoint used to retrieve user information from an access token.

Returned Datatypes

The returned datatype OidcIdentityProvider has its own parameters. Below is a list of them along with their datatypes and a description of each:

Table: OidcIdentityProvider

ParameterTypeRequiredDefaultDescription
Some arguments may be required, as indicated in the Required column. For some fields, this column indicates that a result will always be returned for this column.
authenticationMethodAuthenticationMethodAuthyes The authentication method used. See AuthenticationMethodAuth.
authorizationEndpointstring  A URL to the endpoint a user should be redirected to when authorizing.
clientIdstringyes The unique identifier for the client.
clientSecretstringyes The password for the client.
debugbooleanyes Whether debugging is enabled.
defaultIdpbooleanyes Whether the identity provider is the default.
domains[string]yes The domains authorized by the OIDC identity providers.
federatedIdpstring  The Federated IdP.
groupsClaimstring  The name of the claim to interpret as the groups in LogScale. The value in the claim must be an array of strings. Optional. Defaults to humio-groups.
humioManagedbooleanyes Whether authentication is managed by LogScale.
idstringyes The unique identifier for the OIDC identity provider.
issuerstringyes The issuer of the OIDC authentication.
jwksEndpointstring  A URL to the JWKS endpoint for retrieving keys for validating tokens. Required.
lazyCreateUsersbooleanyes Whether to wait to create users until necessary.
namestringyes The name of the OIDC identity provider.
registrationEndpointstring  To use OIDC as a client, PUBLIC_URL must be set, LogScale must be registered as a client with your OpenID provider, and the provider must allow %PUBLIC_URL%/auth/oidc as a valid redirect endpoint for the client.
scopeClaimstring  The scope claim.
scopes[string]yes Comma-separated list of scopes to add in addition to the default requested scopes (openid, email, and profile).
tokenEndpointstring  A URL to the token endpoint used to exchange a authentication code to an access token. Required for clients.
tokenEndpointAuthMethodstringyes A URL to the token endpoint used to exchange a authentication code to an access token. Required for clients.
userClaimstringyes The name of the claim to interpret as username in LogScale. The value in the claim must be a string. Defaults to humio-user. Can be set to email if using emails as usernames.
userInfoEndpointstring  A URL to the user info endpoint used to retrieve user information from an access token.