Update Authentication Configuration (Server-only)

PUT {{baseUrl}}/api/-/authn-service/auth-configurations/:id

Update an authentication instance.

Note: The request body must specify all the required and desired parameters, not jus the parameters you want to update.

Version: Available in API 3.19 (Tableau Server 2023.1) and later. Not available for Tableau Cloud. Versioning Overview

Permissions: This method can only be called by users with server administrator permissions. Permissions Overview

License: No additional license required.

Access Scope: Not available.
Access Scopes Overview: Server-Windows | Server-Linux

Request Body

{"id"=>"<integer>", "auth_type"=>"OIDC", "iframed_idp_enabled"=>"<boolean>", "oidc"=>{"client_id"=>"<string>", "client_secret"=>"<string>", "config_url"=>"<string>", "custom_scope"=>"<string>", "id_claim"=>"<string>", "username_claim"=>"<string>", "client_authentication"=>"<string>", "essential_acr_values"=>"<string>", "voluntary_acr_values"=>"<string>", "prompt"=>"<string>", "connection_timeout"=>"<integer>", "read_timeout"=>"<integer>", "ignore_domain"=>"<boolean>", "ignore_jwk"=>"<boolean>"}}

HEADERS

KeyDatatypeRequiredDescription
X-Tableau-AuthstringThe Tableau authentication header. The value is a credentials token from a Tableau server's response to an authentication request.
The Content-Type and Accept headers should be the mediatype of the request and response except in cases where you want to explicitly allow other versions of the resource.
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;auth_configuration&quot;:{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;created_at&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cstring\u003e&quot;,&quot;auth_type&quot;:&quot;OIDC&quot;,&quot;iframed_idp_enabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;oidc&quot;:{&quot;client_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;client_secret&quot;:&quot;\u003cstring\u003e&quot;,&quot;config_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_scope&quot;:&quot;\u003cstring\u003e&quot;,&quot;id_claim&quot;:&quot;\u003cstring\u003e&quot;,&quot;username_claim&quot;:&quot;\u003cstring\u003e&quot;,&quot;client_authentication&quot;:&quot;\u003cstring\u003e&quot;,&quot;essential_acr_values&quot;:&quot;\u003cstring\u003e&quot;,&quot;voluntary_acr_values&quot;:&quot;\u003cstring\u003e&quot;,&quot;prompt&quot;:&quot;\u003cstring\u003e&quot;,&quot;connection_timeout&quot;:&quot;\u003cinteger\u003e&quot;,&quot;read_timeout&quot;:&quot;\u003cinteger\u003e&quot;,&quot;ignore_domain&quot;:&quot;\u003cboolean\u003e&quot;,&quot;ignore_jwk&quot;:&quot;\u003cboolean\u003e&quot;}}}