Ajouter et gérer des comptes utilisateur

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Pour que les utilisateurs puissent commencer à utiliser le portail de services pour les développeurs, vous devez les ajouter au système. Par défaut, tout utilisateur peut s'inscrire sur le portail des développeurs en sélectionnant le lien "Enregistrer" dans le menu du portail. Le compte de l'utilisateur est ensuite automatiquement authentifié, et le rôle d'utilisateur authentifié lui est attribué.

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

Une fois qu'un compte utilisateur a été ajouté, un administrateur peut lui attribuer un rôle, qui lui associe les droits associés. De plus, un administrateur peut gérer un compte utilisateur existant, y compris modifier le profil utilisateur, supprimer le compte, bloquer ou débloquer le compte, ou attribuer un nouveau rôle au compte. Un administrateur peut également spécifier ce qu'il advient du compte utilisateur et de son contenu associé (par exemple, des articles de blog et des articles de forum) lorsque le compte est désactivé.

Le portail des développeurs peut envoyer automatiquement des e-mails aux utilisateurs lorsque des événements se produisent. Par exemple, le portail peut envoyer un e-mail lorsqu'un utilisateur est ajouté, qu'un compte est bloqué ou qu'un compte est désactivé. 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 la messagerie électronique.

Regardez cette vidéo pour découvrir comment gérer les workflows d'enregistrement, personnaliser les e-mails d'inscription, bloquer l'enregistrement d'adresses IP, et créer, gérer et bloquer des comptes utilisateur.

Contrôler qui peut 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 contrôler qui peut 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 > People > Account settings (Configuration > Personnes > Paramètres de 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 "Inscription et annulation". Vous disposez des options 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, avec approbation de l'administrateur requise:tout le monde peut s'enregistrer, mais un administrateur doit autoriser le compte.
  4. Cochez ou décochez la case Exiger la validation d'une adresse e-mail lorsqu'un visiteur crée un compte. Lorsque cette option est décochée, le développeur est immédiatement connecté au portail après s'être inscrit. Lorsque cette option est cochée, l'utilisateur reçoit un e-mail qui lui permet de 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 des utilisateurs manuellement, ou les utilisateurs peuvent ajouter eux-mêmes des utilisateurs en sélectionnant le lien "Register" (Enregistrer) sur le portail des développeurs.

Ajouter manuellement un compte utilisateur

Pour ajouter un compte utilisateur manuellement:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
  2. Sélectionnez People > Add User (Personnes > Ajouter un utilisateur) dans le menu d'administration de Drupal.
  3. Saisissez les informations de l'utilisateur dans les champs "First Name", "Last Name", "Username", "Email address" et "Password", puis indiquez que vous acceptez le contrat utilisateur.
  4. Vous pouvez également définir l'état et les rôles de l'utilisateur.
  5. Sélectionnez Informer l'utilisateur de la création d'un compte pour générer un e-mail automatique qui sera envoyé à l'utilisateur.
  6. Cliquez sur Créer un compte.

Enregistrer un utilisateur à partir du portail des développeurs

Pour enregistrer un utilisateur à partir du portail des 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 et sélectionne Créer un compte.
    En fonction des paramètres d'enregistrement du nouveau compte, un e-mail de bienvenue automatique est envoyé à l'utilisateur lorsque celui-ci est créé.

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 Configurer la messagerie électronique.

Toutefois, les administrateurs du portail ne sont pas avertis par défaut de l'inscription d'un nouvel utilisateur. 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 lors de la création du compte. Sinon, le compte utilisateur reste inactif.

Pour avertir les administrateurs lorsqu'un nouvel utilisateur crée 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 > People > Admin Notification (Configuration > Personnes > Notification administrateur) dans le menu d'administration de Drupal.
  3. Sous Alertes utilisateur, indiquez le destinataire de l'e-mail. Vous pouvez la diriger vers :
    • Envoyer à une adresse e-mail personnalisée
    • Envoyer à un rôle spécifique Si vous choisissez cette option, vous souhaiterez peut-être créer un autre rôle. Sinon, si vous choisissez un rôle tel que "Administrateur", tous les administrateurs recevront l'e-mail, qui risque de ne pas s'appliquer à tous les administrateurs.
    • Les deux
  4. Modifiez l'objet et le corps du message.
  5. Choisissez d'envoyer l'e-mail lorsque :
    • Recevoir un e-mail lors de la création de l'utilisateur
    • Recevoir un e-mail lors de la création et de la mise à jour d'un compte utilisateur
  6. Cliquez sur Enregistrer la configuration.

Gérer un compte utilisateur

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

Pour modifier le profil d'un utilisateur:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
  2. Sélectionnez People (Contacts) 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, "toutes" est sélectionné pour ces filtres, auquel cas, tous les utilisateurs sont répertoriés sur la page.

  4. Cliquez sur Modifier sur 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 de façon appropriée.
  6. Cliquez sur Enregistrer.

Ajout du captcha

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

Drupal prend en charge d'autres modules CAPTCHA, tels que les images CAPTCHA, que vous pouvez également utiliser sur le portail.

Vidéo:regardez une courte vidéo sur l'activation du CAPTCHA sur le portail des développeurs.

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. Pour demander des clés reCAPTCHA auprès de Google, accédez à la page https://www.google.com/recaptcha/intro/index.html.
  5. Sélectionnez Configuration > People > CAPTCHA > reCAPTCHA (Configuration > Contacts > CAPTCHA > reCAPTCHA) dans le menu Drupal.
  6. Indiquez la clé publique (clé de site Google) et la clé privée (clé secrète Google). Vous pouvez conserver les valeurs par défaut des autres paramètres.
  7. Sélectionnez Configuration > People > CAPTCHA (Configuration > Contacts > CAPTCHA) pour définir l'emplacement où vous souhaitez présenter le formulaire reCAPTCHA. Par défaut, il apparaît sur les formulaires de connexion et d'inscription des utilisateurs.
  8. Sur cette page, définissez le type de défi pour chaque formulaire.
  9. Enregistrez les modifications.

Ajout d'une page de conditions générales

Vous pouvez ajouter au portail des développeurs une page de conditions d'utilisation que les utilisateurs doivent accepter lorsqu'ils se connectent pour être autorisés à accéder au portail. Si vous modifiez la page "Conditions d'utilisation" ultérieurement, les utilisateurs devront accepter les conditions 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 offre un moyen flexible de créer une page de conditions d'utilisation, suit l'historique des révisions des conditions d'utilisation et suit les utilisateurs qui les ont acceptées.

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

Pour activer le module "Juridique" :

  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 et cochez la case située à côté du module juridique.
  4. Cliquez sur Enregistrer la configuration.

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

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez Configuration > People > Legal (Configuration > Personnes > Juridique) dans le menu d'administration de Drupal.
    Cet élément de menu n'apparaît que lorsque le module "Juridique" est activé. La zone supérieure de la page, sous Version/Révision la plus récente, affiche les conditions d'utilisation actuelles. Si les conditions d'utilisation ne sont pas définies, cette zone est vide. Pour créer une version, accédez à la section "Conditions d'utilisation" sous "Créer une version/une traduction".
  3. Saisissez vos conditions d'utilisation dans la section "Conditions d'utilisation".
  4. Sélectionnez le mode d'affichage des conditions d'utilisation sur la page: Zone de défilement, Zone de défilement (CSS), Texte HTML ou Lien de la page.
  5. Vous pouvez éventuellement ajouter des cases à cocher et une zone de texte décrivant les dernières modifications.
  6. Sélectionnez Prévisualiser 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 surveiller 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 > People > Legal (Configuration > Personnes > Juridique) dans le menu d'administration de Drupal.
  3. Sélectionnez l'onglet T&C History (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.

Redirection d'un utilisateur à la connexion

Par défaut, lorsqu'un utilisateur se connecte au portail, il est redirigé vers une page qui affiche ses informations, telles que son prénom et son nom. Vous pouvez également utiliser le module Drupal Rules (Règles Drupal) pour ajouter une règle permettant de rediriger automatiquement l'utilisateur vers une autre page. Par exemple, vous pouvez rediriger l'utilisateur vers la page répertoriant 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 sont pas déjà activés :
    • Alias "me" (s'affiche en haut de la liste des modules, et non dans leur ordre alphabétique comme le font tous les autres modules)
    • LoginToboggan
    • Règles
    • UI des règles
  4. Cliquez sur Enregistrer la configuration.
    Il est possible que d'autres modules obligatoires soient activés automatiquement.

Créer une règle de redirection des connexions :

  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 + Ajouter une règle sur la page "Règles".
  4. Indiquez le nom de la règle: redirection de connexion.
  5. Vous pouvez éventuellement spécifier une balise pour les informations de connexion.
  6. Dans la boîte déroulante "Réagir à l'événement", sélectionnez Utilisateur > L'utilisateur s'est connecté.
  7. Sélectionnez Enregistrer.
    La page "Modifier une règle de réaction" s'affiche. Comme vous avez déjà défini l'événement à l'étape précédente, celui-ci doit 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 Système > Redirection de la page dans le menu déroulant.
    La mise en page de la page "Ajouter une action" est modifiée pour vous permettre de spécifier l'URL de redirection.
  10. Sous "Valeur", indiquez user/[account:uid]/apps.
    [account:uid] est un schéma de remplacement qui correspond à l'ID de portail de l'utilisateur. Pour afficher la liste complète des schémas de remplacement, sélectionnez "Modèles de remplacement" dans la zone de saisie "Valeur".
  11. Cliquez sur Enregistrer pour revenir à la page "Modifier une règle de réaction". Cette page devrait s'afficher comme indiqué ci-dessous:
  12. Cliquez sur Enregistrer les modifications.
    Pour modifier la règle ultérieurement, sélectionnez "Règles" sur la page "Configuration", puis sélectionnez "Redirection de la 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 du portail. Par exemple, http://dev-myCompany.devportal.apigee.io/.

Définir des rôles utilisateur et des autorisations

Un rôle définit un ensemble spécifique d'autorisations permettant à un utilisateur d'effectuer certaines activités. Pour accorder des droits à un utilisateur ou à un groupe d'utilisateurs, vous devez l'attribuer à un rôle disposant des autorisations nécessaires. Les administrateurs gèrent les rôles et définissent des autorisations pour les rôles sur le portail des développeurs.

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

  • utilisateur anonyme : rôle de tout utilisateur qui ne s'est pas connecté. Les utilisateurs anonymes sont empêchés d'effectuer la plupart des actions.
  • Utilisateur authentifié : rôle par défaut attribué à tous les utilisateurs. Vous pouvez attribuer d'autres rôles à un utilisateur, mais ce rôle leur est toujours attribué.

En outre, Apigee a ajouté le rôle d'administrateur. Attribuez le rôle Administrateur aux utilisateurs pour leur donner des droits d'administration sur le portail.

En règle générale, vous ajoutez des rôles à votre portail afin de pouvoir différencier les autorisations en fonction des différents types d'utilisateurs. Un utilisateur peut avoir un ou plusieurs rôles. Le rôle utilisateur authentifié est attribué à tous les utilisateurs. Toutefois, si vous souhaitez attribuer à un utilisateur des rôles supplémentaires, vous devez ajouter une logique à votre portail ou attribuer les rôles 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 le nom d'un nouveau rôle dans la zone de texte au-dessus du bouton "Ajouter un rôle" de la page "Personnes".
  3. Cliquez sur Ajouter un rôle.

Pour modifier un rôle:

  1. Sélectionnez Personnes > Autorisations > Rôles.
  2. Cliquez sur Modifier le rôle sur la ligne du rôle en question sur la page "Participants".
  3. Modifiez le nom du rôle, le cas échéant.
  4. Cliquez sur Enregistrer.

Pour supprimer un rôle:

  1. Sélectionnez Personnes > Autorisations > Rôles.
  2. Cliquez sur Modifier le rôle sur la ligne du rôle en question sur la page "Participants".
  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 People (Contacts) dans le menu d'administration de Drupal.
  3. Cliquez sur Modifier sur 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 appropriés pour l'utilisateur.
  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 de la page "Personnes".
    Un tableau des rôles et des autorisations s'affiche. Les coches du tableau indiquent quelles autorisations sont attribuées à quels rôles.

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

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

Lorsque l'utilisateur crée un compte sur le portail, le portail affiche la page d'inscription 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 que le nom d'une 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
  • Affichage par différents éléments HTML, tels que des zones de texte, des cases d'option, des cases à cocher, etc.
  • Peut être paramétré pour s'afficher n'importe où dans le formulaire

Pour découvrir comment personnaliser le formulaire d'inscription des utilisateurs disponible sur le portail des développeurs, regardez cette vidéo.

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, facultatifs et obligatoires.

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. Sélectionnez People (Personnes) dans le menu d'administration Drupal du portail.
  2. Sélectionnez Modifier sur la ligne correspondant au nom de l'utilisateur.

C'est la principale façon dont vous, en tant qu'administrateur, accédez aux informations des utilisateurs.

Par défaut, lorsque vous ajoutez de nouveaux champs au formulaire, les valeurs des champs ne sont pas téléchargées dans Edge. Vous pouvez toutefois configurer le portail pour importer 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 accéder à ces champs à partir d'un script.

Par exemple, affichez les nouveaux champs de formulaire dans l'interface utilisateur de gestion Edge en accédant à Publier > Développeurs,puis en sélectionnant le nom d'utilisateur. Les valeurs du nouveau champ apparaissent dans la zone "Attributs personnalisés" de la page et portent un nom qui correspond au nom interne du champ:

Pour ajouter un champ au formulaire d'inscription de l'utilisateur:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant des droits d'administrateur ou de création de contenu.
  2. Sélectionnez Configuration > People > Account Settings (Configuration > Utilisateurs > Paramètres de compte) dans le menu d'administration de Drupal.
  3. Cliquez sur le bouton Gérer les champs en haut de la page.
  4. Faites défiler la page jusqu'à la zone "Add new field" (Ajouter un champ) :
  5. Configurez le champ. Par exemple, pour le champ "Company Name" (Nom de l'entreprise) 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 de ce champ.
  8. Saisissez la longueur maximale, puis sélectionnez Enregistrer les paramètres de champ.
  9. Une nouvelle page s'affiche. Elle vous permet de spécifier des informations supplémentaires pour le champ, y compris les suivantes :
    • Case à cocher permettant de le définir comme un champ obligatoire.
    • Case à cocher permettant d'afficher le champ.
    • Texte d'aide facultatif s'affichant dans une fenêtre pop-up dans le formulaire.
    • Autres paramètres.
  10. N'oubliez pas de 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 pour que le nouveau champ apparaisse sur 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 apparaissent au 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 > People > Account Settings (Configuration > Utilisateurs > Paramètres de 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é" et faites glisser le champ vers 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 les 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 d'entité d'accès, par exemple, pour activer un comportement dynamique basé sur les valeurs des attributs personnalisés.

Pour savoir comment enregistrer les valeurs des champs de formulaire en tant qu'attributs de développeur personnalisés, regardez cette vidéo.

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 > Portail de développement > Attributs du développeur) dans le menu d'administration de Drupal.
    La liste des champs disponibles s'affiche.
  3. Sélectionnez le champ que vous souhaitez conserver en tant qu'attribut dans Edge, tel que Nom de l'entreprise.
  4. Cochez la case Persistance de ce champ en tant qu'attribut dans Edge.
  5. Spécifiez le nom de l'attribut Edge. Il s'agit du nom qui apparaît dans la colonne "Nom" du tableau des attributs personnalisés de 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 vrai|false) si vous souhaitez caster la valeur en tant que valeur booléenne et la convertir en chaîne vrai ou faux avant de l'envoyer à Edge.
  8. Cliquez sur Enregistrer la configuration.
    L'attribut personnalisé est maintenant importé dans Edge lorsque l'utilisateur envoie le formulaire. Si, en tant qu'administrateur, vous souhaitez modifier la valeur d'un champ personnalisé, faites-le à partir du portail et non à partir d'Edge.

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

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

Vous contrôlez entièrement les propriétés de l'application par défaut, y compris:

  • Produits d'API inclus dans l'application
  • État de l'application: en attente ou approuvée
  • L'URL de rappel, si nécessaire
  • Paramètres personnalisés appliqués à l'application

Pour contrôler la création d'une application par défaut, vous pouvez créer une règle à l'aide du module Drupal Rules (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 correspond à un utilisateur qui crée 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 permettant de configurer une application. Ces attributs peuvent être facultatifs ou obligatoires, selon la façon dont vous les avez définis. 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 sont pas déjà activés :
    • Alias "me" (s'affiche en haut de la liste des modules, et non dans leur ordre alphabétique comme le font tous les autres modules)
    • LoginToboggan
    • Règles
    • UI des règles
  4. Cliquez sur Enregistrer la configuration.
    Il est possible que d'autres modules obligatoires soient activés automatiquement.

Créer 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. Indiquez le nom de la règle.
  5. Vous pouvez également spécifier une connexion dans le champ Tags ou toute autre balise que vous souhaitez utiliser pour classer la règle.
  6. Dans la boîte 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 des règles s'affiche. Comme vous avez déjà défini l'événement à l'étape précédente, celui-ci doit indiquer "Après avoir enregistré un nouveau compte utilisateur" 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 > Create a developer application (Devconnect > Créer une application de développement) dans le menu déroulant.
    La mise en page de la page "Ajouter une action" change pour vous permettre de configurer l'application.
  11. Sous Nom de l'API, indiquez 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 motifs de remplacement, sélectionnez Remplacement dans la zone de saisie Valeur.
  12. Définissez UID du développeur sur [account:uid]. Cette valeur est obligatoire pour associer l'utilisateur à l'application.
  13. Définissez l'état de l'application sur en attente ou approuvée. Définissez-la sur pending 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 n'apparaît que si vous avez configuré des applications pour qu'elles nécessitent 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 la section 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 répertorier chaque produit d'API sur une ligne distincte, sans virgules ni autres délimiteurs. La liste des produits d'API disponibles est affichée au-dessus de la zone de texte Value (Valeur).
  17. Cliquez sur Enregistrer pour revenir à la page "Modification de la règle".
  18. Cliquez sur Enregistrer les modifications.
  19. Pour modifier la règle ultérieurement, sélectionnez Configuration > Workflow > Règles dans le menu d'administration de Drupal, puis sélectionnez la règle dans la liste des règles.

Lorsqu'un nouvel utilisateur se connecte au portail pour la première fois et sélectionne le lien "Mes applications" dans le menu, il voit maintenant une application nommée Application lastName, dans laquelle lastName correspond au nom utilisé lors de l'enregistrement du 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 à partir du portail. À partir de ce rapport, un administrateur peut consulter 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éveloppement dans le menu d'administration de Drupal. Une liste triable des applications utilisateur s'affiche.
  3. Pour toute 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.

Désactivation d'un compte utilisateur

Un administrateur du portail peut annuler un compte utilisateur. L'administrateur peut désactiver un compte individuel ou plusieurs comptes à la fois.

Pour désactiver un compte utilisateur individuel :

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez People (Contacts) dans le menu d'administration de Drupal.
  3. Dans la colonne Opérations du tableau des utilisateurs, sélectionnez Désactiver le compte.
  4. Cliquez sur l'option de résiliation appropriée sous "En cas de désactivation d'un compte utilisateur". Vous disposez des options suivantes :
    • Désactiver le compte et conserver son contenu: (par défaut) le compte utilisateur et son contenu associé sont conservés. Toutefois, l'accès aux ressources de l'API est bloqué pour le compte utilisateur. 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 de l'utilisateur est supprimé. Le compte utilisateur ne peut pas accéder aux ressources de l'API. Un administrateur peut ensuite débloquer le compte utilisateur.
    • Supprimer le compte tout en faisant en sorte que son contenu appartienne à l'utilisateur anonyme : le compte utilisateur est supprimé. Le contenu associé au compte utilisateur est conservé, mais il est associé au compte utilisateur "anonyme", c'est-à-dire à un compte non authentifié. Impossible de réactiver le compte utilisateur. 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. Impossible de réactiver le compte utilisateur. 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 l'annulation, sélectionnez Exiger une confirmation par e-mail pour désactiver le compte.
    Si vous sélectionnez cette option, le compte de l'utilisateur doit disposer des autorisations appropriées pour permettre la résiliation. Sélectionnez People > Permissions (Personnes > Autorisations) et assurez-vous que l'autorisation "Cancel own user account" (Annuler son propre compte utilisateur) est définie pour le rôle "authenticated user" (Utilisateur authentifié).
  6. Cliquez sur Désactiver le compte.

Pour désactiver plusieurs comptes utilisateur:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez People (Contacts) dans le menu d'administration de Drupal.
  3. Sous Opérations, sélectionnez Annuler un 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 Execute (Exécuter).
  6. Cliquez sur l'option de résiliation appropriée sous "En cas de désactivation d'un compte utilisateur". Vous disposez des options suivantes :
    • Désactiver le compte et conserver son contenu
    • Désactivez le compte et annulez la publication de son contenu.
    • Supprimer le compte, mais faire en sorte que son contenu appartienne à l'utilisateur anonyme.
    • Supprimer le compte et son contenu
  7. Cliquez sur Suivant.
  8. Cliquez sur Confirmer.

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

Les administrateurs du portail des 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 désactivé:

  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 "Inscription et annulation". Vous disposez des options suivantes :
    • Désactiver le compte et conserver son contenu
    • Désactivez le compte et annulez la publication de son contenu.
    • Supprimer le compte, mais faire en sorte que son contenu appartienne à l'utilisateur anonyme.
    • Supprimer le compte et son contenu
  5. Cliquez sur Enregistrer la configuration.