Mettre à jour la configuration LDAP

Version 3.1.23.2

Mettez à jour la configuration LDAP.

La configuration de LDAP a une incidence sur l'authentification pour tous les utilisateurs. Cette configuration doit être effectuée avec précaution.

Seuls les administrateurs Looker peuvent lire et mettre à jour la configuration LDAP.

LDAP est activé ou désactivé pour Looker à l'aide du champ enabled.

Nous vous recommandons fortement de tester les modifications de paramètre LDAP à l'aide des API ci-dessous avant de les définir de manière globale.

Pour en savoir plus, consultez la documentation LDAP sur Looker.

Demande

PATCH /ldap_config
Type de données
Description
Demande
HTTPRequest
body
Corps HTTP
Développer la définition HTTPBody...
body
Configuration LDAP
Développer la définition de LDAPConfig...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
autre_adresse_e-mail_autorisée
booléen
Autorisez une connexion par e-mail secondaire via "/login/email" pour les administrateurs et les utilisateurs spécifiés disposant de l'autorisation "login_special_email". Cette option est utile en tant que solution de secours lors de la configuration de LDAP, si des problèmes de configuration LDAP surviennent plus tard ou si vous devez aider des utilisateurs qui ne figurent pas dans votre annuaire LDAP. Les connexions à des adresses e-mail et des mots de passe Looker sont toujours désactivées pour les utilisateurs standards lorsque LDAP est activé.
mot_de_passe_auth
string
(Écriture seule) Mot de passe du compte LDAP utilisé pour accéder au serveur LDAP
Authentification requise
booléen
Les utilisateurs ne seront pas autorisés à se connecter, sauf si un rôle leur est attribué dans LDAP s'il est défini sur "true"
nom_d'authentification
string
Nom distinctif du compte LDAP utilisé pour accéder au serveur LDAP
hôte_connexion
string
Nom d'hôte du serveur LDAP
port_connexion
string
Port hôte LDAP
tl_connexion
booléen
Utiliser Transport Layer Security
connection_tls_no_verify.
booléen
Ne pas valider le pair lors de l'utilisation du protocole TLS
id_groupes_nouveaux_utilisateurs_par_défaut
entier[]
groupes_nouveaux_utilisateurs par défaut
Groupe[]
id_nouveau_rôle_par_utilisateur_par_défaut
entier[]
rôles_utilisateur_par_défaut
Rôle[]
activé
booléen
Activer/Désactiver l'authentification LDAP pour le serveur
force_no_page
booléen
N'essayez pas de paginer les résultats de recherche LDAP (RFC 2696), même si le serveur LDAP prétend les accepter.
groupes
groupes_base_dn
string
Base de données pour trouver des groupes dans les recherches LDAP
type_recherche_groupes
string
Identifiant d'une stratégie permettant à Looker de rechercher des groupes sur le serveur LDAP
Attribut
string
Attribut de groupe LDAP qui signifie les membres des groupes. Plus souvent, "membre"
classes_objets_groupes
string
Liste facultative de classes d'objets LDAP séparées par une virgule pour les groupes lors de recherches
Attribut utilisateur_groupes
string
Attribut de groupe LDAP correspondant à l'utilisateur d'un groupe. Le plus souvent "dn"
groupes_avec_identifiants_rôles
has_auth_password
booléen
(Lecture seule) Le mot de passe associé au compte LDAP utilisé pour accéder au serveur LDAP a-t-il été défini ?
fusionner_nouveaux_utilisateurs_par_e-mail
booléen
Fusionnez la première connexion LDAP au compte utilisateur existant à l'aide des adresses e-mail. Lorsqu'un utilisateur se connecte pour la première fois via LDAP, cette option le connecte à son compte existant en recherchant le compte associé à une adresse e-mail correspondante. Dans le cas contraire, un compte utilisateur est créé.
modifié_à
string
Date de la dernière modification de cette configuration
modifié_par
string
ID utilisateur de la dernière modification de cette configuration
Définir des rôles à partir de groupes
booléen
Définir des rôles utilisateur dans Looker en fonction des groupes de LDAP
mot_de_passe_ldap_test
string
(Écriture seule) Testez le mot de passe de l'utilisateur LDAP. Pour les tests LDAP uniquement.
utilisateur_ldap_test
string
(Écriture seule) Testez l'ID de connexion de l'utilisateur LDAP. Pour les tests LDAP uniquement.
Adresse e-mail de l'attribut user_attribute_map
string
Nom des attributs de l'enregistrement de l'utilisateur utilisés pour indiquer le champ d'adresse e-mail
nom_premier_attribut_utilisateur
string
Nom des attributs de l'enregistrement de l'utilisateur utilisés pour indiquer le prénom.
nom_utilisateur_map_nom_utilisateur
string
Nom des attributs de l'enregistrement de l'utilisateur utilisés pour indiquer le nom de famille
id_utilisateur_map_ldap_id
string
Nom des attributs de l'enregistrement de l'utilisateur utilisés pour indiquer un ID d'enregistrement unique
attributs_utilisateur
attributs_utilisateur_avec_identifiants
utilisateur_base_base
string
Nom distinctif du nœud LDAP utilisé comme base pour les recherches des utilisateurs
user_custom_filter
string
(Facultatif) Clause de filtre RFC-2254 personnalisée à utiliser pour rechercher l'utilisateur lors de la connexion. Associée à l'aide de "et" avec les autres clauses de filtrage générées.
user_id_attribute_names [nom_attribut_utilisateur]
string
Noms des attributs d'enregistrement de l'utilisateur utilisés pour établir la correspondance de l'ID de connexion utilisateur (liste d'éléments séparés par une virgule)
class_objet_utilisateur
string
(Facultatif) Nom de la classe d'objets d'enregistrement de l'utilisateur utilisée pour rechercher l'utilisateur durant l'identifiant de connexion
autoriser_normal_group_membership
booléen
Autoriser les utilisateurs authentifiés par LDAP à être membres des groupes Looker non renvoyées. Si la valeur est "false", l'utilisateur est supprimé des groupes non renvoyés à la connexion.
allow_roles_from_normal_groups (groupes de rôles autorisés)
booléen
Les utilisateurs LDAP autorisés pourront hériter des rôles de groupes Looker non renvoyées.
allow_direct_roles (rôles directs)
booléen
Permet d'attribuer directement des rôles aux utilisateurs authentifiés par LDAP.
url
string
Lien pour obtenir cet élément

Réponse

200: Nouvel état pour la configuration LDAP.

Type de données
Description
(objet)
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
autre_adresse_e-mail_autorisée
booléen
Autorisez une connexion par e-mail secondaire via "/login/email" pour les administrateurs et les utilisateurs spécifiés disposant de l'autorisation "login_special_email". Cette option est utile en tant que solution de secours lors de la configuration de LDAP, si des problèmes de configuration LDAP surviennent plus tard ou si vous devez aider des utilisateurs qui ne figurent pas dans votre annuaire LDAP. Les connexions à des adresses e-mail et des mots de passe Looker sont toujours désactivées pour les utilisateurs standards lorsque LDAP est activé.
mot_de_passe_auth
string
(Écriture seule) Mot de passe du compte LDAP utilisé pour accéder au serveur LDAP
Authentification requise
booléen
Les utilisateurs ne seront pas autorisés à se connecter, sauf si un rôle leur est attribué dans LDAP s'il est défini sur "true"
nom_d'authentification
string
Nom distinctif du compte LDAP utilisé pour accéder au serveur LDAP
hôte_connexion
string
Nom d'hôte du serveur LDAP
port_connexion
string
Port hôte LDAP
tl_connexion
booléen
Utiliser Transport Layer Security
connection_tls_no_verify.
booléen
Ne pas valider le pair lors de l'utilisation du protocole TLS
id_groupes_nouveaux_utilisateurs_par_défaut
entier[]
groupes_nouveaux_utilisateurs par défaut
Groupe[]
Développer la définition du groupe...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
métadonnées_ajout_à_contenu
booléen
Le groupe peut être utilisé dans les contrôles d'accès au contenu
contient_utilisateur_actuel
booléen
L'utilisateur actuellement connecté est membre du groupe
id_groupe_externe
string
Groupe d'ID externe si le groupe d'intégration
géré en externe
booléen
Appartenance à un groupe contrôlé en dehors de Looker
id
integer
Identifiant unique
inclure_par_défaut
booléen
Les nouveaux utilisateurs sont ajoutés à ce groupe par défaut
name
string
Nom du groupe
nombre_utilisateurs
integer
Nombre d'utilisateurs inclus dans ce groupe
id_nouveau_rôle_par_utilisateur_par_défaut
entier[]
rôles_utilisateur_par_défaut
Rôle[]
Développer la définition du rôle...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id
integer
Identifiant unique
name
string
Nom du rôle
Autorisation définie
(Lecture seule) Autorisation définie
Développer la définition de l'ensemble d'autorisations...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
accès complet
booléen
intégré
booléen
id
integer
Identifiant unique
name
string
Nom du jeu d'autorisations
autorisations
chaîne[]
url
string
Lien pour obtenir cet élément
id_autorisation
integer
(Écriture seule) ID de l'autorisation
ensemble_modèles
(Lecture seule) Ensemble de modèles
Développer la définition de l'ensemble de modèles...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
accès complet
booléen
intégré
booléen
id
integer
Identifiant unique
modèles
chaîne[]
name
string
Nom de l'ensemble de modèles
url
string
Lien pour obtenir cet élément
id_ensemble_modèle
integer
(Écriture seule) ID de l'ensemble de modèles
url
string
Lien pour obtenir cet élément
URL des utilisateurs
string
Lien pour obtenir la liste des utilisateurs disposant de ce rôle
activé
booléen
Activer/Désactiver l'authentification LDAP pour le serveur
force_no_page
booléen
N'essayez pas de paginer les résultats de recherche LDAP (RFC 2696), même si le serveur LDAP prétend les accepter.
groupes
Développer la définition LDAPGroupRead...
id
integer
Identifiant unique
id_groupe_Looker
integer
ID unique du groupe dans Looker
nom_groupe_Looker
string
Nom du groupe dans Looker
name
string
Nom du groupe dans LDAP
rôles
Rôle[]
Développer la définition du rôle...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id
integer
Identifiant unique
name
string
Nom du rôle
Autorisation définie
(Lecture seule) Autorisation définie
id_autorisation
integer
(Écriture seule) ID de l'autorisation
ensemble_modèles
(Lecture seule) Ensemble de modèles
id_ensemble_modèle
integer
(Écriture seule) ID de l'ensemble de modèles
url
string
Lien pour obtenir cet élément
URL des utilisateurs
string
Lien pour obtenir la liste des utilisateurs disposant de ce rôle
url
string
Lien vers la configuration LDAP
groupes_base_dn
string
Base de données pour trouver des groupes dans les recherches LDAP
type_recherche_groupes
string
Identifiant d'une stratégie permettant à Looker de rechercher des groupes sur le serveur LDAP
Attribut
string
Attribut de groupe LDAP qui signifie les membres des groupes. Plus souvent, "membre"
classes_objets_groupes
string
Liste facultative de classes d'objets LDAP séparées par une virgule pour les groupes lors de recherches
Attribut utilisateur_groupes
string
Attribut de groupe LDAP correspondant à l'utilisateur d'un groupe. Le plus souvent "dn"
groupes_avec_identifiants_rôles
Développer la définition de LDAPGroupWrite...
id
integer
Identifiant unique
id_groupe_Looker
integer
ID unique du groupe dans Looker
nom_groupe_Looker
string
Nom du groupe dans Looker
name
string
Nom du groupe dans LDAP
id_rôles
entier[]
url
string
Lien vers la configuration LDAP
has_auth_password
booléen
(Lecture seule) Le mot de passe associé au compte LDAP utilisé pour accéder au serveur LDAP a-t-il été défini ?
fusionner_nouveaux_utilisateurs_par_e-mail
booléen
Fusionnez la première connexion LDAP au compte utilisateur existant à l'aide des adresses e-mail. Lorsqu'un utilisateur se connecte pour la première fois via LDAP, cette option le connecte à son compte existant en recherchant le compte associé à une adresse e-mail correspondante. Dans le cas contraire, un compte utilisateur est créé.
modifié_à
string
Date de la dernière modification de cette configuration
modifié_par
string
ID utilisateur de la dernière modification de cette configuration
Définir des rôles à partir de groupes
booléen
Définir des rôles utilisateur dans Looker en fonction des groupes de LDAP
mot_de_passe_ldap_test
string
(Écriture seule) Testez le mot de passe de l'utilisateur LDAP. Pour les tests LDAP uniquement.
utilisateur_ldap_test
string
(Écriture seule) Testez l'ID de connexion de l'utilisateur LDAP. Pour les tests LDAP uniquement.
Adresse e-mail de l'attribut user_attribute_map
string
Nom des attributs de l'enregistrement de l'utilisateur utilisés pour indiquer le champ d'adresse e-mail
nom_premier_attribut_utilisateur
string
Nom des attributs de l'enregistrement de l'utilisateur utilisés pour indiquer le prénom.
nom_utilisateur_map_nom_utilisateur
string
Nom des attributs de l'enregistrement de l'utilisateur utilisés pour indiquer le nom de famille
id_utilisateur_map_ldap_id
string
Nom des attributs de l'enregistrement de l'utilisateur utilisés pour indiquer un ID d'enregistrement unique
attributs_utilisateur
Développer la définition LDAPUserAttributeRead...
name
string
Nom de l'attribut utilisateur dans LDAP
required
booléen
Vous devez vous trouver dans l'assertion LDAP pour que la connexion aboutisse.
attributs_utilisateur
Développer la définition de l'attribut utilisateur
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id
integer
Identifiant unique
name
string
Nom de l'attribut utilisateur
label
string
Libellé lisible pour l'attribut utilisateur
type
string
Type d'attribut utilisateur ("chaîne", "nombre", "datetime", "yesno", "code postal")
default_value
string
Valeur par défaut lorsqu'aucune valeur n'est définie pour l'utilisateur
Is_system
booléen
L'attribut est un paramètre système par défaut
est_permanent
booléen
L'attribut est définitif et ne peut pas être supprimé
valeur_est_masquée
booléen
Si la valeur est "true", les utilisateurs ne pourront pas afficher les valeurs de cet attribut
visionnage_utilisateur
booléen
Les utilisateurs qui ne sont pas administrateurs peuvent voir les valeurs de leurs attributs et les utiliser dans les filtres
Modification par l'utilisateur
booléen
Les utilisateurs peuvent modifier la valeur de cet attribut pour eux-mêmes
domaine_valeur_masquée_liste_blanche
string
Destinations vers lesquelles un attribut masqué peut être envoyé. Une fois défini, ce paramètre ne peut plus être modifié.
url
string
Lien vers la configuration LDAP
attributs_utilisateur_avec_identifiants
Développer la définition de LDAPUserAttributeWrite...
name
string
Nom de l'attribut utilisateur dans LDAP
required
booléen
Vous devez vous trouver dans l'assertion LDAP pour que la connexion aboutisse.
id_attribut_utilisateur
entier[]
url
string
Lien vers la configuration LDAP
utilisateur_base_base
string
Nom distinctif du nœud LDAP utilisé comme base pour les recherches des utilisateurs
user_custom_filter
string
(Facultatif) Clause de filtre RFC-2254 personnalisée à utiliser pour rechercher l'utilisateur lors de la connexion. Associée à l'aide de "et" avec les autres clauses de filtrage générées.
user_id_attribute_names [nom_attribut_utilisateur]
string
Noms des attributs d'enregistrement de l'utilisateur utilisés pour établir la correspondance de l'ID de connexion utilisateur (liste d'éléments séparés par une virgule)
class_objet_utilisateur
string
(Facultatif) Nom de la classe d'objets d'enregistrement de l'utilisateur utilisée pour rechercher l'utilisateur durant l'identifiant de connexion
autoriser_normal_group_membership
booléen
Autoriser les utilisateurs authentifiés par LDAP à être membres des groupes Looker non renvoyées. Si la valeur est "false", l'utilisateur est supprimé des groupes non renvoyés à la connexion.
allow_roles_from_normal_groups (groupes de rôles autorisés)
booléen
Les utilisateurs LDAP autorisés pourront hériter des rôles de groupes Looker non renvoyées.
allow_direct_roles (rôles directs)
booléen
Permet d'attribuer directement des rôles aux utilisateurs authentifiés par LDAP.
url
string
Lien pour obtenir cet élément

400 Bad Request

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

403: Autorisation refusée

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

404: introuvable

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

422: Erreur de validation

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
Développer la définition de ValidationErrorDetail...
champ
string
Champ comportant une erreur
code
string
Code d'erreur
Message
string
Message d'information sur l'erreur
documentation_url
string
Lien vers la documentation
documentation_url
string
Lien vers la documentation