Files
authentik/website/docs/developer-docs/api/reference/providers-ldap-update.api.mdx
Tana M Berry 7a6d44d0df first pass
2024-10-22 15:10:13 -05:00

669 lines
28 KiB
Plaintext

---
id: providers-ldap-update
title: "providers_ldap_update"
description: "LDAPProvider Viewset"
sidebar_label: "providers_ldap_update"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "put api-method"
info_path: docs/developer-docs/api/reference/authentik
custom_edit_url: null
hide_send_button: true
---
import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Heading from "@theme/Heading";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
<Heading
as={"h1"}
className={"openapi__heading"}
children={"providers_ldap_update"}
>
</Heading>
<MethodEndpoint
method={"put"}
path={"/providers/ldap/{id}/"}
>
</MethodEndpoint>
LDAPProvider Viewset
<Heading
id={"request"}
as={"h2"}
className={"openapi-tabs__heading"}
children={"Request"}
>
</Heading>
<details
style={{"marginBottom":"1rem"}}
className={"openapi-markdown__details"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
>
<h3
className={"openapi-markdown__details-summary-header-params"}
>
Path Parameters
</h3>
</summary><div>
<ul>
<ParamsItem
className={"paramsItem"}
param={{"in":"path","name":"id","schema":{"type":"integer"},"description":"A unique integer value identifying this LDAP Provider.","required":true}}
>
</ParamsItem>
</ul>
</div>
</details><MimeTabs
className={"openapi-tabs__mime"}
>
<TabItem
label={"application/json"}
value={"application/json-schema"}
>
<details
style={{}}
className={"openapi-markdown__details mime"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
className={"openapi-markdown__details-summary-mime"}
>
<h3
className={"openapi-markdown__details-summary-header-body"}
>
Body
</h3><strong
className={"openapi-schema__required"}
>
required
</strong>
</summary><div
style={{"textAlign":"left","marginLeft":"1rem"}}
>
</div><ul
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={false}
name={"name"}
required={true}
schemaName={"string"}
qualifierMessage={"**Possible values:** `non-empty`"}
schema={{"type":"string","minLength":1}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"authentication_flow"}
required={false}
schemaName={"uuid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"uuid","nullable":true,"description":"Flow used for authentication when the associated application is accessed by an un-authenticated user."}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"authorization_flow"}
required={true}
schemaName={"uuid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"uuid","description":"Flow used when authorizing this provider."}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"property_mappings"}
required={false}
schemaName={"uuid[]"}
qualifierMessage={undefined}
schema={{"type":"array","items":{"type":"string","format":"uuid"}}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"base_dn"}
required={false}
schemaName={"string"}
qualifierMessage={"**Possible values:** `non-empty`"}
schema={{"type":"string","minLength":1,"description":"DN under which objects are accessible."}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"certificate"}
required={false}
schemaName={"uuid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"uuid","nullable":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"tls_server_name"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"uid_start_number"}
required={false}
schemaName={"integer"}
qualifierMessage={"**Possible values:** `>= -2147483648` and `<= 2147483647`"}
schema={{"type":"integer","maximum":2147483647,"minimum":-2147483648,"description":"The start for uidNumbers, this number is added to the user.pk to make sure that the numbers aren't too low for POSIX users. Default is 2000 to ensure that we don't collide with local users uidNumber"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"gid_start_number"}
required={false}
schemaName={"integer"}
qualifierMessage={"**Possible values:** `>= -2147483648` and `<= 2147483647`"}
schema={{"type":"integer","maximum":2147483647,"minimum":-2147483648,"description":"The start for gidNumbers, this number is added to a number generated from the group.pk to make sure that the numbers aren't too low for POSIX groups. Default is 4000 to ensure that we don't collide with local groups or users primary groups gidNumber"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"search_mode"}
required={false}
schemaName={"LDAPAPIAccessMode (string)"}
qualifierMessage={"**Possible values:** [`direct`, `cached`]"}
schema={{"enum":["direct","cached"],"type":"string","title":"LDAPAPIAccessMode"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"bind_mode"}
required={false}
schemaName={"LDAPAPIAccessMode (string)"}
qualifierMessage={"**Possible values:** [`direct`, `cached`]"}
schema={{"enum":["direct","cached"],"type":"string","title":"LDAPAPIAccessMode"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"mfa_support"}
required={false}
schemaName={"boolean"}
qualifierMessage={undefined}
schema={{"type":"boolean","description":"When enabled, code-based multi-factor authentication can be used by appending a semicolon and the TOTP code to the password. This should only be enabled if all users that will bind to this provider have a TOTP device configured, as otherwise a password may incorrectly be rejected if it contains a semicolon."}}
>
</SchemaItem>
</ul>
</details>
</TabItem>
</MimeTabs><div>
<div>
<ApiTabs
label={undefined}
id={undefined}
>
<TabItem
label={"200"}
value={"200"}
>
<div>
</div><div>
<MimeTabs
className={"openapi-tabs__mime"}
schemaType={"response"}
>
<TabItem
label={"application/json"}
value={"application/json"}
>
<SchemaTabs
className={"openapi-tabs__schema"}
>
<TabItem
label={"Schema"}
value={"Schema"}
>
<details
style={{}}
className={"openapi-markdown__details response"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
className={"openapi-markdown__details-summary-response"}
>
<strong>
Schema
</strong>
</summary><div
style={{"textAlign":"left","marginLeft":"1rem"}}
>
</div><ul
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={false}
name={"pk"}
required={true}
schemaName={"ID (integer)"}
qualifierMessage={undefined}
schema={{"type":"integer","readOnly":true,"title":"ID"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"name"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"authentication_flow"}
required={false}
schemaName={"uuid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"uuid","nullable":true,"description":"Flow used for authentication when the associated application is accessed by an un-authenticated user."}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"authorization_flow"}
required={true}
schemaName={"uuid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"uuid","description":"Flow used when authorizing this provider."}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"property_mappings"}
required={false}
schemaName={"uuid[]"}
qualifierMessage={undefined}
schema={{"type":"array","items":{"type":"string","format":"uuid"}}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"component"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Get object component so that we know how to edit the object","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"assigned_application_slug"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Internal application name, used in URLs.","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"assigned_application_name"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Application's display Name.","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"assigned_backchannel_application_slug"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Internal application name, used in URLs.","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"assigned_backchannel_application_name"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Application's display Name.","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"verbose_name"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Return object's verbose_name","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"verbose_name_plural"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Return object's plural verbose_name","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"meta_model_name"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"Return internal model name","readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"base_dn"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","description":"DN under which objects are accessible."}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"certificate"}
required={false}
schemaName={"uuid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"uuid","nullable":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"tls_server_name"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"uid_start_number"}
required={false}
schemaName={"integer"}
qualifierMessage={"**Possible values:** `>= -2147483648` and `<= 2147483647`"}
schema={{"type":"integer","maximum":2147483647,"minimum":-2147483648,"description":"The start for uidNumbers, this number is added to the user.pk to make sure that the numbers aren't too low for POSIX users. Default is 2000 to ensure that we don't collide with local users uidNumber"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"gid_start_number"}
required={false}
schemaName={"integer"}
qualifierMessage={"**Possible values:** `>= -2147483648` and `<= 2147483647`"}
schema={{"type":"integer","maximum":2147483647,"minimum":-2147483648,"description":"The start for gidNumbers, this number is added to a number generated from the group.pk to make sure that the numbers aren't too low for POSIX groups. Default is 4000 to ensure that we don't collide with local groups or users primary groups gidNumber"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"outpost_set"}
required={true}
schemaName={"string[]"}
qualifierMessage={undefined}
schema={{"type":"array","items":{"type":"string"},"readOnly":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"search_mode"}
required={false}
schemaName={"LDAPAPIAccessMode (string)"}
qualifierMessage={"**Possible values:** [`direct`, `cached`]"}
schema={{"enum":["direct","cached"],"type":"string","title":"LDAPAPIAccessMode"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"bind_mode"}
required={false}
schemaName={"LDAPAPIAccessMode (string)"}
qualifierMessage={"**Possible values:** [`direct`, `cached`]"}
schema={{"enum":["direct","cached"],"type":"string","title":"LDAPAPIAccessMode"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"mfa_support"}
required={false}
schemaName={"boolean"}
qualifierMessage={undefined}
schema={{"type":"boolean","description":"When enabled, code-based multi-factor authentication can be used by appending a semicolon and the TOTP code to the password. This should only be enabled if all users that will bind to this provider have a TOTP device configured, as otherwise a password may incorrectly be rejected if it contains a semicolon."}}
>
</SchemaItem>
</ul>
</details>
</TabItem><TabItem
label={"Example (from schema)"}
value={"Example (from schema)"}
>
<ResponseSamples
responseExample={"{\n \"pk\": 0,\n \"name\": \"string\",\n \"authentication_flow\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"authorization_flow\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"property_mappings\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"component\": \"string\",\n \"assigned_application_slug\": \"string\",\n \"assigned_application_name\": \"string\",\n \"assigned_backchannel_application_slug\": \"string\",\n \"assigned_backchannel_application_name\": \"string\",\n \"verbose_name\": \"string\",\n \"verbose_name_plural\": \"string\",\n \"meta_model_name\": \"string\",\n \"base_dn\": \"string\",\n \"certificate\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"tls_server_name\": \"string\",\n \"uid_start_number\": 0,\n \"gid_start_number\": 0,\n \"outpost_set\": [\n \"string\"\n ],\n \"search_mode\": \"direct\",\n \"bind_mode\": \"direct\",\n \"mfa_support\": true\n}"}
language={"json"}
>
</ResponseSamples>
</TabItem>
</SchemaTabs>
</TabItem>
</MimeTabs>
</div>
</TabItem><TabItem
label={"400"}
value={"400"}
>
<div>
</div><div>
<MimeTabs
className={"openapi-tabs__mime"}
schemaType={"response"}
>
<TabItem
label={"application/json"}
value={"application/json"}
>
<SchemaTabs
className={"openapi-tabs__schema"}
>
<TabItem
label={"Schema"}
value={"Schema"}
>
<details
style={{}}
className={"openapi-markdown__details response"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
className={"openapi-markdown__details-summary-response"}
>
<strong>
Schema
</strong>
</summary><div
style={{"textAlign":"left","marginLeft":"1rem"}}
>
</div><ul
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={false}
name={"non_field_errors"}
required={false}
schemaName={"string[]"}
qualifierMessage={undefined}
schema={{"type":"array","items":{"type":"string"}}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"code"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem><SchemaItem
name={"property name*"}
required={false}
schemaName={"any"}
qualifierMessage={undefined}
schema={{"type":"object","description":"Validation Error","properties":{"non_field_errors":{"type":"array","items":{"type":"string"}},"code":{"type":"string"}},"additionalProperties":{},"title":"ValidationError"}}
collapsible={false}
discriminator={false}
>
</SchemaItem>
</ul>
</details>
</TabItem><TabItem
label={"Example (from schema)"}
value={"Example (from schema)"}
>
<ResponseSamples
responseExample={"{\n \"non_field_errors\": [\n \"string\"\n ],\n \"code\": \"string\"\n}"}
language={"json"}
>
</ResponseSamples>
</TabItem>
</SchemaTabs>
</TabItem>
</MimeTabs>
</div>
</TabItem><TabItem
label={"403"}
value={"403"}
>
<div>
</div><div>
<MimeTabs
className={"openapi-tabs__mime"}
schemaType={"response"}
>
<TabItem
label={"application/json"}
value={"application/json"}
>
<SchemaTabs
className={"openapi-tabs__schema"}
>
<TabItem
label={"Schema"}
value={"Schema"}
>
<details
style={{}}
className={"openapi-markdown__details response"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
className={"openapi-markdown__details-summary-response"}
>
<strong>
Schema
</strong>
</summary><div
style={{"textAlign":"left","marginLeft":"1rem"}}
>
</div><ul
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={false}
name={"detail"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"code"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string"}}
>
</SchemaItem>
</ul>
</details>
</TabItem><TabItem
label={"Example (from schema)"}
value={"Example (from schema)"}
>
<ResponseSamples
responseExample={"{\n \"detail\": \"string\",\n \"code\": \"string\"\n}"}
language={"json"}
>
</ResponseSamples>
</TabItem>
</SchemaTabs>
</TabItem>
</MimeTabs>
</div>
</TabItem>
</ApiTabs>
</div>
</div>