Ajouter et gérer des comptes utilisateur

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info

Avant que les utilisateurs puissent commencer à utiliser votre portail de services pour les développeurs, ils doivent être ajoutés au système. Par défaut, n'importe quel utilisateur peut s'inscrire sur le portail des développeurs en sélectionnant le lien "S'inscrire" dans le menu du portail. Le compte de l'utilisateur est ensuite authentifié automatiquement et il est attribué au rôle d'utilisateur authentifié.

Vous pouvez personnaliser votre portail des développeurs afin que seuls les utilisateurs disposant d'un accès administrateur puissent ajouter des comptes utilisateur. Dans ce cas, un administrateur doit ajouter manuellement des comptes utilisateur. Un administrateur peut également avoir besoin d'ajouter manuellement des comptes utilisateur pour des développeurs internes ou pour le compte d'un client.

Une fois un compte utilisateur ajouté, un administrateur peut lui attribuer un rôle, ce qui associe les droits de ce rôle au compte. De plus, un administrateur peut gérer un compte utilisateur existant, y compris en modifiant le profil utilisateur du compte, en le supprimant, en le bloquant ou en le débloquant, ou en lui attribuant un nouveau rôle. Un administrateur peut également spécifier ce qui se passe avec le compte utilisateur et le contenu associé (par exemple, les articles de blog et les posts sur les forums) lorsque le compte est résilié.

Le portail pour les développeurs peut envoyer automatiquement des e-mails aux utilisateurs lorsqu'un événement se produit. Par exemple, le portail peut envoyer un e-mail lorsqu'un utilisateur est ajouté, qu'un compte est bloqué ou qu'un compte est résilié. Dans le cadre de la gestion des utilisateurs, vous pouvez contrôler le contenu et le format de ces e-mails. Pour en savoir plus, consultez la section Configurer l'envoi d'e-mails.

Contrôler les personnes autorisées à enregistrer des comptes

Par défaut, n'importe quel utilisateur peut créer un compte à partir du portail des développeurs en cliquant sur le lien "S'inscrire".

Pour définir les personnes autorisées à enregistrer des comptes:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Configuration > Personnes > Paramètres du compte dans le menu d'administration de Drupal. La page "Paramètres du compte" s'ouvre.
3. Cliquez sur l'option d'enregistrement appropriée sous "Qui peut enregistrer des comptes ?" dans la section "Enregistrement et résiliation". Les options sont les suivantes :
   • Administrateurs uniquement:seuls les administrateurs peuvent enregistrer des comptes utilisateur.
   • Visiteurs: tout le monde peut s'inscrire. Il s'agit de la valeur par défaut.
   • Visiteurs, mais approbation de l'administrateur requise:tout le monde peut s'inscrire, mais un administrateur doit autoriser le compte.
4. Cochez ou décochez la case Exiger la validation de l'adresse e-mail lorsqu'un visiteur crée un compte. Si cette case n'est pas cochée, le développeur est immédiatement connecté au portail après son inscription. Si cette case est cochée, l'utilisateur reçoit un e-mail qu'il doit utiliser pour valider son adresse e-mail avant de pouvoir se connecter.
5. Cliquez sur Enregistrer la configuration.

Ajouter un compte utilisateur

Selon la configuration de votre portail, les administrateurs doivent ajouter les utilisateurs manuellement ou les utilisateurs peuvent s'ajouter eux-mêmes en sélectionnant le lien "S'inscrire" sur le portail des développeurs.

Ajouter un compte utilisateur manuellement

Pour ajouter manuellement un compte utilisateur:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Personnes > Ajouter un utilisateur dans le menu d'administration de Drupal.
3. Saisissez les informations de l'utilisateur dans les champs "Prénom", "Nom", "Nom d'utilisateur", "Adresse e-mail" et "Mot de passe", puis indiquez que vous acceptez les conditions d'utilisation.
4. Vous pouvez également définir l'état et les rôles de l'utilisateur.
5. Sélectionnez Informer l'utilisateur de son nouveau compte pour générer un e-mail automatique envoyé à l'utilisateur.
6. Cliquez sur Créer un compte.

Enregistrer un utilisateur depuis le portail des développeurs

Pour enregistrer un utilisateur depuis le portail pour les développeurs:

1. L'utilisateur sélectionne S'inscrire sur la page d'accueil du portail des développeurs.
2. La page d'inscription s'affiche.
3. L'utilisateur saisit les informations requises, puis sélectionne Créer un compte.
   Selon les paramètres d'enregistrement du nouveau compte, un e-mail de bienvenue automatique est envoyé à l'utilisateur lors de la création du compte.

Automatiser la notification de l'administrateur lorsqu'un nouvel utilisateur s'inscrit

Par défaut, lorsqu'un nouvel utilisateur s'inscrit sur le portail, il reçoit un e-mail. Pour en savoir plus, consultez la section Configurer l'envoi d'e-mails.

Toutefois, les administrateurs du portail ne reçoivent pas de notification par défaut lorsqu'un nouvel utilisateur s'inscrit. Par exemple, si vous configurez le portail de sorte que les nouveaux utilisateurs aient besoin d'une approbation administrative pour activer leur compte, vous devez vous assurer que les administrateurs sont avertis lorsque le nouveau compte est créé. Dans le cas contraire, le compte utilisateur reste inactif.

Pour informer les administrateurs lorsqu'un nouvel utilisateur enregistre un compte:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Configuration > Personnes > Notification de l'administrateur dans le menu d'administration de Drupal.
3. Sous Alertes utilisateur, indiquez qui recevra l'e-mail. Vous pouvez l'envoyer à :
   • Envoyer à une adresse e-mail personnalisée
   • Envoyer à un rôle spécifique Si vous choisissez cette option, vous pouvez créer un rôle. Sinon, si vous choisissez un rôle tel qu'administrateur, tous les administrateurs recevront l'e-mail, qui ne sera peut-être pas applicable à tous.
   • Les deux
4. Modifiez l'objet et le corps du message.
5. Sélectionnez l'envoi de l'e-mail :
   • Recevoir un e-mail lors de la création d'un utilisateur
   • Recevoir un e-mail lors de la création et de la mise à jour d'un utilisateur
6. Cliquez sur Enregistrer la configuration.

Gérer un compte utilisateur

Les administrateurs peuvent gérer les comptes utilisateur pour définir des informations utilisateur, réinitialiser des mots de passe, activer des comptes, les annuler ou les suspendre, et effectuer d'autres tâches.

Pour modifier le profil utilisateur d'un compte utilisateur:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Personnes dans le menu d'administration de Drupal.
3. Utilisez la zone de filtre en haut de la page pour filtrer l'affichage des utilisateurs en fonction d'un nom d'utilisateur, d'une adresse e-mail, d'un état ou d'une autorisation spécifiques. Par défaut, "n'importe quel" est sélectionné pour ces filtres. Dans ce cas, tous les utilisateurs sont listés sur la page.
   

   

4. Cliquez sur Modifier dans la ligne "Nom d'utilisateur" du compte utilisateur. Une vue modifiable du profil de l'utilisateur s'ouvre.
5. Modifiez les données du profil utilisateur si nécessaire.
6. Cliquez sur Enregistrer.

Ajouter un CAPTCHA

Vous pouvez ajouter un test CAPTCHA à la page de connexion et à d'autres pages en activant les modules Drupal CAPTCHA et reCAPTCHA. Le module reCAPTCHA permet d'utiliser le service reCAPTCHA sans frais de Google.

Drupal est compatible avec d'autres modules CAPTCHA, tels que les CAPTCHA image, que vous pouvez également utiliser sur le portail.

Pour activer reCAPTCHA:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Modules dans le menu Drupal.
3. Activez les modules CAPTCHA et reCAPTCHA.
4. Demandez des clés reCAPTCHA à Google sur la page https://www.google.com/recaptcha/intro/index.html.
5. Sélectionnez Configuration > Personnes > CAPTCHA > reCAPTCHA dans le menu Drupal.
6. Saisissez la clé publique (clé de site Google) et la clé privée (clé secrète Google). Vous pouvez conserver les valeurs par défaut pour les autres paramètres.
7. Sélectionnez Configuration > Personnes > CAPTCHA pour définir l'emplacement où vous souhaitez que le formulaire reCAPTCHA s'affiche. Par défaut, il s'affiche sur les formulaires de connexion et d'enregistrement des utilisateurs.
8. Sur cette page, définissez le type de défi pour chaque formulaire.
9. Enregistrez les modifications.

Ajouter une page des conditions d'utilisation

Vous pouvez ajouter une page des conditions d'utilisation au portail des développeurs que les utilisateurs doivent accepter lorsqu'ils se connectent avant d'être autorisés à accéder au portail. Si vous modifiez ultérieurement la page des conditions d'utilisation, les utilisateurs devront accepter les conditions d'utilisation mises à jour lors de leur prochaine connexion.

L'implémentation de la page des conditions d'utilisation utilise le module juridique de Drupal. Ce module permet de créer de manière flexible une page des conditions d'utilisation, de suivre l'historique des révisions des conditions d'utilisation et de suivre les utilisateurs qui ont accepté les conditions d'utilisation.

Une fois créée, la page des conditions d'utilisation a l'URL <siteURL>/legal.

Pour activer le module "Législation" :

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Modules dans le menu d'administration de Drupal. La liste de tous les modules Drupal installés s'affiche.
3. Faites défiler la page vers le bas, puis cochez la case à côté du module juridique.
4. Cliquez sur Enregistrer la configuration.

Pour créer une page des conditions d'utilisation:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Configuration > Personnes > Mentions légales dans le menu d'administration de Drupal.
   Cet élément de menu ne s'affiche que lorsque le module "Législation" est activé. Le cadre supérieur de la page, sous "Dernière version/révision", affiche les conditions d'utilisation en vigueur. Si vous n'avez pas défini de conditions d'utilisation, cette zone est vide. Vous créez une version dans la section "Conditions d'utilisation" sous "Créer une version/traduction".
3. Saisissez vos conditions d'utilisation dans la section "Conditions d'utilisation".
4. Choisissez comment afficher les conditions d'utilisation sur la page: Scroll Box, Scroll Box (CSS), Texte HTML ou Lien vers la page.
5. Vous pouvez ajouter des cases à cocher supplémentaires et une zone de texte décrivant vos dernières modifications.
6. Sélectionnez Aperçu pour prévisualiser vos conditions d'utilisation dans la section "Conditions d'utilisation" sous "Version/Révision la plus récente", ou Enregistrer pour les enregistrer.

Pour suivre les modifications apportées aux conditions d'utilisation et leur acceptation:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Configuration > Personnes > Mentions légales dans le menu d'administration de Drupal.
3. Sélectionnez l'onglet Historique des conditions d'utilisation pour afficher l'historique des révisions des conditions d'utilisation.
4. Sélectionnez l'onglet Acceptées pour afficher la liste des utilisateurs qui ont accepté chaque version des conditions d'utilisation.

Rediriger un utilisateur à la connexion

Par défaut, lorsqu'un utilisateur se connecte au portail, il est redirigé vers une page qui affiche ses informations, comme son prénom et son nom. Vous pouvez également utiliser le module Règles Drupal pour ajouter une règle redirigeant automatiquement l'utilisateur vers une autre page. Par exemple, vous pouvez rediriger l'utilisateur vers la page qui liste toutes ses applications ou vers la page d'accueil du portail.

Avant de pouvoir créer une règle de redirection, vous devez vous assurer que tous les modules Drupal nécessaires sont activés.

Activez les modules Drupal nécessaires:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Modules dans le menu d'administration de Drupal.
3. Activez les modules suivants s'ils ne le sont pas déjà :
   • Alias "moi" (s'affiche en haut de la liste des modules, et non à sa place alphabétique comme tous les autres modules)
   • LoginToboggan
   • Règles
   • UI des règles
4. Cliquez sur Enregistrer la configuration.
   Vous pouvez voir d'autres modules requis activés automatiquement.

Créez une règle de redirection de connexion:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Configuration > Workflow > Rules (Configuration > Workflow > Règles) dans le menu d'administration de Drupal.
3. Sur la page "Règles", sélectionnez + Ajouter une règle.
4. Spécifiez le nom de la règle : "Redirection de connexion".
5. Vous pouvez éventuellement spécifier une balise comme identifiant de connexion.
6. Dans la liste déroulante "Réagir à l'événement", sélectionnez Utilisateur > L'utilisateur s'est connecté.
   
7. Sélectionnez Enregistrer.
   La page "Modifier la règle de réaction" s'affiche. Vous avez déjà défini l'événement à l'étape précédente. Il devrait donc indiquer "L'utilisateur s'est connecté" sous "Événement". Laissez le champ "Conditions" vide pour cette règle.
8. Sous "Actions", sélectionnez + Ajouter une action.
9. Sélectionnez System > Page Redirect (Système > Redirection de page) dans le menu déroulant.
   La page "Ajouter une action" change de mise en page pour vous permettre de spécifier l'URL de redirection.
10. Sous "Valeur", spécifiez user/[account:uid]/apps.
    [account:uid] est un modèle de remplacement qui correspond à l'ID du portail de l'utilisateur. Pour afficher la liste complète des modèles de remplacement, sélectionnez "Modèles de remplacement" sous la zone de saisie de la valeur.
11. Cliquez sur Enregistrer pour revenir à la page "Modifier la règle de réaction". Cette page doit s'afficher comme indiqué ci-dessous:
    
12. Cliquez sur Enregistrer les modifications.
    Pour modifier ultérieurement la règle, sélectionnez "Règles" sur la page "Configuration", puis "Redirection de connexion" dans la liste des règles.

Désormais, lorsqu'un utilisateur se connecte, il est redirigé vers la page qui liste toutes ses applications. Si vous souhaitez plutôt les rediriger vers la page d'accueil du portail, modifiez la valeur que vous avez définie ci-dessus à l'étape 11 pour spécifier l'URL de la page d'accueil de votre portail. Par exemple, http://dev-monEntreprise.devportal.apigee.io/.

Définir les rôles utilisateur et les autorisations

Un rôle définit un ensemble spécifique d'autorisations qui permet à un utilisateur d'effectuer certaines activités. Pour accorder des droits à un utilisateur ou à un groupe d'utilisateurs, attribuez-lui un rôle disposant des autorisations nécessaires. Les administrateurs gèrent les rôles, y compris en définissant des autorisations pour les rôles, sur le portail pour les développeurs.

Par défaut, Drupal crée deux rôles:

• Utilisateur anonyme : rôle attribué à tout utilisateur qui n'est pas connecté. Les utilisateurs anonymes ne peuvent pas effectuer la plupart des actions.
• Utilisateur authentifié : rôle par défaut attribué à tous les utilisateurs. Vous pouvez attribuer à un utilisateur des rôles supplémentaires, mais il conserve toujours ce rôle.

De plus, Apigee a ajouté le rôle d'administrateur. Attribuez le rôle d'administrateur aux utilisateurs pour leur accorder des droits d'administration sur le portail.

En règle générale, vous ajoutez des rôles à votre portail afin de différencier les autorisations en fonction des types d'utilisateurs. Un utilisateur peut avoir un seul rôle ou plusieurs. Tous les utilisateurs sont affectés au rôle d'utilisateur authentifié, mais si vous souhaitez attribuer des rôles supplémentaires à un utilisateur, vous devez ajouter une logique à votre portail ou effectuer l'attribution de rôle manuellement.

Pour afficher tous les rôles et autorisations:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Personnes > Autorisations > Rôles dans le menu d'administration de Drupal.

Pour ajouter un rôle:

1. Sélectionnez Personnes > Autorisations > Rôles.
2. Saisissez un nouveau nom de rôle dans la zone de texte située au-dessus du bouton "Ajouter un rôle" sur la page "Personnes".
3. Cliquez sur le rôle Ajouter.

Pour modifier un rôle:

1. Sélectionnez Personnes > Autorisations > Rôles.
2. Cliquez sur Modifier le rôle dans la ligne du rôle concerné sur la page "Personnes".
3. Modifiez le nom du rôle, si nécessaire.
4. Cliquez sur Enregistrer.

Pour supprimer un rôle:

1. Sélectionnez Personnes > Autorisations > Rôles.
2. Cliquez sur Modifier le rôle dans la ligne du rôle concerné sur la page "Personnes".
3. Cliquez sur Supprimer le rôle.

Pour ajouter un utilisateur à un rôle:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Personnes dans le menu d'administration de Drupal.
3. Cliquez sur Modifier dans la ligne "Nom d'utilisateur" du compte utilisateur. Une vue modifiable du profil de l'utilisateur s'ouvre.
4. Sélectionnez tous les rôles pour l'utilisateur, le cas échéant.
5. Cliquez sur Enregistrer.

Pour modifier les autorisations d'un rôle:

1. Sélectionnez Personnes > Autorisations > Rôles.
2. Cliquez sur l'onglet Autorisation sur la page "Personnes".
   Un tableau des rôles et des autorisations s'affiche. Les coches dans le tableau indiquent les autorisations attribuées à chaque rôle.
   

   

3. Cochez ou décochez une case pour accorder ou révoquer l'autorisation associée à ce rôle.
   Par exemple, pour empêcher les utilisateurs authentifiés de créer ou de supprimer des applications, faites défiler la section Applications de développement DevConnet du tableau des autorisations, puis décochez les cases Créer des applications de développement et Supprimer des applications de développement sous Utilisateurs authentifiés.
4. Cliquez sur Enregistrer les autorisations.

Personnaliser les champs de formulaire utilisés pour enregistrer un utilisateur

Lorsque l'utilisateur s'inscrit pour un compte sur le portail, celui-ci affiche la page d'enregistrement par défaut avec les champs Prénom, Nom, Nom d'utilisateur, Adresse e-mail et Mot de passe. En tant que fournisseur d'API, vous pouvez modifier ce formulaire pour inviter l'utilisateur à fournir des informations supplémentaires, telles qu'un nom d'entreprise, une adresse postale ou d'autres informations. Le portail vous permet d'ajouter des champs à ce formulaire. Ces champs peuvent être:

• Obligatoire ou facultatif
• Affichées par différents éléments HTML, tels que des zones de texte, des cases d'option, des cases à cocher, etc.
• Peut être défini pour s'afficher n'importe où dans le formulaire

Par exemple, vous pouvez ajouter un champ obligatoire pour le nom de l'entreprise ou un champ facultatif pour le numéro de téléphone. Vous pouvez également ajouter plusieurs champs, obligatoires et facultatifs.

L'image suivante montre un champ obligatoire pour le nom de l'entreprise ajouté au formulaire:

En tant qu'administrateur du portail, vous pouvez afficher et modifier les informations de l'utilisateur, y compris les champs personnalisés, en procédant comme suit:

1. En sélectionnant Personnes dans le menu d'administration Drupal du portail.
2. En sélectionnant Modifier dans la ligne correspondant au nom de l'utilisateur.

Il s'agit du principal moyen d'accéder aux informations utilisateur en tant qu'administrateur.

Par défaut, lorsque vous ajoutez des champs au formulaire, leurs valeurs ne sont pas importées dans Edge. Toutefois, vous pouvez configurer le portail pour qu'il importe ces valeurs lorsque l'utilisateur envoie le formulaire. Cela signifie que vous pouvez afficher ces champs dans Edge ou utiliser l'API de gestion Edge pour y accéder à partir d'un script.

Par exemple, pour afficher les nouveaux champs de formulaire dans l'UI de gestion Edge, accédez à Publier > Développeurs, puis sélectionnez le nom d'utilisateur. Les nouvelles valeurs de champ s'affichent dans la zone "Attributs personnalisés" de la page avec un nom correspondant au nom interne du champ:

Pour ajouter un champ au formulaire d'inscription des utilisateurs:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Configuration > Personnes > Paramètres du compte dans le menu d'administration de Drupal.
3. Sélectionnez le bouton Gérer les champs en haut de la page.
4. Faites défiler la page jusqu'à la zone "Ajouter un champ" :
   
5. Configurez le champ. Par exemple, pour le champ "Nom de l'entreprise" affiché ci-dessus, utilisez les paramètres suivants:
   
6. Sélectionnez Enregistrer.
7. Comme il s'agit d'un champ de texte, vous êtes invité à spécifier la longueur maximale du champ.
8. Saisissez la longueur maximale, puis sélectionnez Enregistrer les paramètres du champ.
9. Une nouvelle page s'affiche, vous permettant de spécifier des informations supplémentaires pour le champ, y compris les suivantes :
   • Une case à cocher pour définir ce champ comme obligatoire
   • Case à cocher pour spécifier l'affichage du champ.
   • Texte d'aide facultatif qui s'affiche dans un pop-up du formulaire.
   • Autres paramètres.
10. Veillez à cocher la case pour rendre ce champ obligatoire.
11. Si vous apportez des modifications sur cette page, enregistrez vos paramètres.
    Vous devrez peut-être vider le cache de votre navigateur avant que le nouveau champ n'apparaisse dans le formulaire.

Pour réorganiser les attributs du formulaire:

Par défaut, les nouveaux champs obligatoires apparaissent dans le formulaire après le champ "Nom". Les champs facultatifs s'affichent en bas du formulaire, après les champs de mot de passe.

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Configuration > Personnes > Paramètres du compte dans le menu d'administration de Drupal.
3. Sélectionnez le bouton Gérer les champs en haut de la page.
4. Sélectionnez le symbole plus + sous la colonne "Libellé", puis faites glisser le champ à l'emplacement où vous souhaitez l'afficher dans le formulaire.
5. Enregistrez les modifications.

Enregistrer les valeurs des champs de formulaire en tant qu'attributs de développeur personnalisés dans Edge

Vous pouvez enregistrer les valeurs des champs de formulaire dans des attributs de développeur personnalisés dans Edge. Vous pouvez afficher et gérer les attributs personnalisés d'un développeur comme décrit dans la section Gérer les développeurs d'applications.

Une fois les attributs de développeur personnalisés enregistrés, vous pouvez utiliser la règle AccessEntity, par exemple, pour activer un comportement dynamique en fonction des valeurs des attributs personnalisés.

Pour enregistrer les valeurs des champs en tant qu'attributs de développeur personnalisés dans Edge:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Configuration > Dev Portal > Developer Attributes (Configuration > Dev Portal > Attributs du développeur) dans le menu d'administration de Drupal.
   Une liste des champs disponibles s'affiche.
3. Sélectionnez le champ que vous souhaitez conserver en tant qu'attribut dans Edge, par exemple "Nom de l'entreprise".
4. Cochez la case Conserver ce champ en tant qu'attribut dans Edge.
5. Spécifiez le nom de l'attribut de bord. Il s'agit du nom qui apparaît dans la colonne "Nom" du tableau "Attributs personnalisés" pour l'utilisateur.
6. Spécifiez le comportement d'un champ vide.
7. Sélectionnez la chaîne Convert value to true|false (Convertir la valeur en "true" ou "false") si vous souhaitez caster la valeur en tant que valeur booléenne et la convertir en chaîne "true" ou "false" avant de l'envoyer à Edge.
8. Cliquez sur Enregistrer la configuration.
   Désormais, l'attribut personnalisé sera importé dans Edge lorsque l'utilisateur enverra le formulaire. Si, en tant qu'administrateur, vous souhaitez modifier la valeur d'un champ personnalisé, faites-le depuis le portail, et non depuis Edge.

Créer une application par défaut lorsqu'un utilisateur enregistre un compte

Vous pouvez créer automatiquement une application par défaut lorsqu'un utilisateur enregistre un nouveau compte de portail. Lorsque l'utilisateur se connecte pour la première fois, l'application apparaît sur sa page "Mes applications". Selon les autorisations attribuées au rôle de l'utilisateur, vous pouvez lui permettre d'ajouter d'autres applications, ou il peut s'agir de la seule application disponible pour l'utilisateur.

Vous avez un contrôle total sur les propriétés de l'application par défaut, y compris les suivantes:

• Produits d'API inclus par l'application
• État de l'application: en attente ou approuvé
• L'URL de rappel, le cas échéant
• Paramètres personnalisés appliqués à l'application

Pour contrôler la création d'une application par défaut, créez une règle à l'aide du module de règles Drupal. Une règle vous permet de définir une action qui se produit en réponse à un événement sur le portail. Dans ce scénario, l'événement est un utilisateur qui s'inscrit pour un compte sur le portail. L'action consiste à créer une application par défaut pour l'utilisateur.

La section Personnaliser les champs de formulaire utilisés pour enregistrer une application explique comment ajouter des attributs personnalisés utilisés pour configurer une application. Ces attributs peuvent être facultatifs ou obligatoires, selon la façon dont vous les définissez. Si vous avez créé des attributs d'application personnalisés, vous pouvez les définir lorsque vous définissez une application par défaut.

Activez les modules de règles Drupal:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Modules dans le menu d'administration de Drupal.
3. Activez les modules suivants s'ils ne le sont pas déjà :
   • Alias "moi" (s'affiche en haut de la liste des modules, et non à sa place alphabétique comme tous les autres modules)
   • LoginToboggan
   • Règles
   • UI des règles
4. Cliquez sur Enregistrer la configuration.
   Vous pouvez voir d'autres modules requis activés automatiquement.

Créez une règle pour ajouter une application par défaut:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Configuration > Workflow > Rules (Configuration > Workflow > Règles) dans le menu d'administration de Drupal.
3. Sélectionnez le bouton + Ajouter une règle.
4. Spécifiez le nom de la règle.
5. Vous pouvez spécifier une connexion dans le champ Tags ou toute autre balise que vous souhaitez utiliser pour classer la règle.
6. Dans la liste déroulante Réagir à l'événement, sélectionnez Utilisateur > Après avoir enregistré un nouveau compte utilisateur.
7. Sélectionnez Enregistrer.
   La page de modification de la règle s'affiche. Vous avez déjà défini l'événement à l'étape précédente. La mention "Après l'enregistrement d'un compte utilisateur" devrait donc s'afficher sous "Événement".
8. Laissez le champ Conditions vide pour cette règle.
9. Sous Actions, sélectionnez + Ajouter une action.
10. Sélectionnez Devconnect > Créer une application pour les développeurs dans le menu déroulant.
    La page "Ajouter une action" change de mise en page pour vous permettre de configurer l'application.
11. Sous Nom de l'API, spécifiez le nom de l'application par défaut. Par exemple, utilisez [account:field_last_name] Application.
    La valeur [account:field_last_name] est un modèle de remplacement qui correspond au nom de famille de l'utilisateur. Pour afficher la liste complète des modèles de remplacement, sélectionnez les modèles de remplacement sous la zone de saisie Valeur.
12. Définissez UID du développeur sur [account:uid]. Cette valeur est requise pour associer l'utilisateur à l'application.
13. Définissez l'état de l'application sur En attente ou Approuvé. Définissez-la sur En attente si un administrateur doit encore approuver l'application avant que l'utilisateur puisse l'utiliser pour accéder à vos API.
14. Si nécessaire, définissez l'URL de rappel pour l'application. Ce champ ne s'affiche que si vous avez configuré les applications pour qu'elles exigent une URL de rappel. Pour en savoir plus sur la configuration des URL de rappel, consultez Configurer la gestion des URL de rappel.
15. Si vous avez défini des attributs d'application personnalisés, facultatifs ou obligatoires, définissez-les. Pour en savoir plus, consultez Personnaliser les champs de formulaire utilisés pour enregistrer une application.
16. Spécifiez les produits d'API inclus dans l'application.
    La zone de texte Valeur doit lister chaque produit d'API sur une ligne distincte, sans virgule ni autre séparateur. La liste des produits d'API disponibles s'affiche au-dessus de la zone de texte Valeur.
17. Cliquez sur Enregistrer pour revenir à la page "Modifier la règle".
18. Cliquez sur Enregistrer les modifications.
19. Pour modifier la règle ultérieurement, sélectionnez Configuration > Workflow > Rules (Configuration > Workflow > Règles) dans le menu d'administration de Drupal, puis sélectionnez la règle dans la liste.

Lorsqu'un nouvel utilisateur se connecte au portail pour la première fois et sélectionne le lien "Mes applications" dans le menu, une application nommée Application lastName s'affiche, où lastName est le nom de famille utilisé lorsque l'utilisateur a enregistré le compte.

Administrer les applications utilisateur

En tant qu'administrateur du portail, vous pouvez utiliser le rapport "Applications de développeur" pour gérer les applications utilisateur directement depuis le portail. À partir de ce rapport, un administrateur peut afficher des informations sur l'application d'un utilisateur, la modifier ou la supprimer. Par exemple, un administrateur de portail peut modifier l'application pour ajouter ou supprimer des produits d'API, modifier l'URL de rappel ou apporter d'autres modifications.

Pour administrer une application utilisateur:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Rapports > Applications de développeur dans le menu d'administration de Drupal. Une liste triable des applications de l'utilisateur s'affiche.
3. Pour chaque application de la liste :
   • Sélectionnez le lien Modifier pour modifier les propriétés de l'application.
   • Sélectionnez le lien Supprimer pour supprimer l'application.

Annuler un compte utilisateur

Un administrateur du portail peut résilier un compte utilisateur. L'administrateur peut résilier un compte individuel ou plusieurs comptes de manière groupée.

Pour résilier un compte utilisateur individuel:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Personnes dans le menu d'administration de Drupal.
3. Dans la colonne Opérations du tableau des utilisateurs, sélectionnez Annuler le compte.
4. Cliquez sur l'option de résiliation appropriée sous "Lors de la résiliation d'un compte utilisateur". Vous avez le choix entre les options suivantes :
   • Désactiver le compte et conserver son contenu: (par défaut) le compte utilisateur et son contenu associé sont conservés. Cependant, le compte utilisateur est bloqué et ne peut pas accéder aux ressources de l'API. Il s'agit de la valeur par défaut. Un administrateur peut ensuite débloquer le compte utilisateur.
   • Désactiver le compte et annuler la publication de son contenu:le compte utilisateur est conservé. Toutefois, le contenu associé au compte utilisateur est supprimé. Le compte utilisateur est bloqué et ne peut pas accéder aux ressources de l'API. Un administrateur peut ensuite débloquer le compte utilisateur.
   • Supprimer le compte, mais faire en sorte que son contenu appartienne à l'utilisateur anonyme : le compte utilisateur est supprimé. Le contenu associé au compte utilisateur est conservé, mais est associé au compte utilisateur "Anonyme", c'est-à-dire un compte qui n'a pas été authentifié. Le compte utilisateur ne peut pas être réactivé. L'utilisateur doit se réinscrire et son compte doit être authentifié avant d'accéder aux ressources de l'API.
   • Supprimer le compte et son contenu: le compte utilisateur et son contenu associé sont supprimés. Le compte utilisateur ne peut pas être réactivé. L'utilisateur doit se réinscrire et son compte doit être authentifié avant d'accéder aux ressources de l'API.
5. Si vous souhaitez que l'utilisateur reçoive un e-mail lui demandant de confirmer la résiliation, sélectionnez Demander une confirmation par e-mail pour résilier le compte.
   Si vous sélectionnez cette option, le compte de l'utilisateur doit disposer des autorisations appropriées pour permettre l'annulation. Sélectionnez Personnes > Autorisations et assurez-vous que le rôle Utilisateur authentifié dispose de l'autorisation Annuler son propre compte utilisateur.
6. Cliquez sur Désactiver le compte.

Pour résilier plusieurs comptes utilisateur:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
2. Sélectionnez Personnes dans le menu d'administration de Drupal.
3. Sous Opérations, sélectionnez Désactiver le compte utilisateur dans le menu déroulant.
4. Cochez la case à côté de chaque utilisateur dont vous souhaitez désactiver le compte.
5. Sélectionnez le bouton Exécuter.
6. Cliquez sur l'option de résiliation appropriée sous "Lors de la résiliation d'un compte utilisateur". Vous avez le choix entre les options suivantes :
   • Désactiver le compte et conserver son contenu
   • Désactiver le compte et annuler la publication de son contenu
   • Supprimer le compte, mais faire en sorte que son contenu appartienne à l'utilisateur anonyme
   • Supprimez le compte et son contenu.
7. Cliquez sur Suivant.
8. Cliquez sur Confirmer.

Définir l'action par défaut lorsqu'un compte est résilié

Les administrateurs du portail pour les développeurs peuvent définir l'action par défaut du portail lorsqu'un compte utilisateur est résilié.

Pour définir l'action par défaut lorsqu'un compte est résilié:

1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
2. Sélectionnez Configuration dans le menu d'administration de Drupal.
3. Sélectionnez Paramètres du compte.
4. Cliquez sur l'option de résiliation appropriée sous "Lors de la résiliation d'un compte utilisateur" dans la section "Enregistrement et résiliation". Les options sont les suivantes :
   • Désactiver le compte et conserver son contenu
   • Désactiver le compte et annuler la publication de son contenu
   • Supprimer le compte, mais faire en sorte que son contenu appartienne à l'utilisateur anonyme
   • Supprimez le compte et son contenu.
5. Cliquez sur Enregistrer la configuration.