Une fois l'installation terminée, vous pouvez réinitialiser les mots de passe suivants :
Les instructions pour réinitialiser chacun de ces mots de passe sont incluses dans les sections suivantes.
Réinitialiser le mot de passe SymasLDAP
La façon dont vous réinitialisez le mot de passe SymasLDAP dépend de votre configuration. Selon votre configuration Edge, SymasLDAP peut être installé en tant que :
- Une seule instance de SymasLDAP installée sur le nœud du serveur de gestion. Par exemple, dans une configuration Edge à 2, 5 ou 9 nœuds.
- Plusieurs instances SymasLDAP installées sur les nœuds du serveur de gestion, configurées avec la réplication SymasLDAP. Par exemple, dans une configuration Edge à 12 nœuds.
- Plusieurs instances SymasLDAP installées sur leurs propres nœuds, configurées avec la réplication SymasLDAP. Par exemple, dans une configuration Edge à 13 nœuds.
Pour une seule instance de SymasLDAP installée sur le serveur de gestion, procédez comme suit :
- Sur le nœud du serveur de gestion, exécutez la commande suivante pour créer le mot de passe SymasLDAP :
/opt/apigee/apigee‑service/bin/apigee‑service apigee‑openldap \ change‑ldap‑password ‑o OLD_PASSWORD ‑n NEW_PASSWORD
- Exécutez la commande suivante pour stocker le nouveau mot de passe afin que le serveur de gestion puisse y accéder :
/opt/apigee/apigee‑service/bin/apigee‑service edge‑management‑server \ store_ldap_credentials ‑p NEW_PASSWORD
Cette commande redémarre le serveur de gestion.
Dans une configuration de réplication SymasLDAP avec SymasLDAP installé sur les nœuds du serveur d'administration, suivez les étapes ci-dessus sur les deux nœuds du serveur d'administration pour mettre à jour le mot de passe.
Dans une configuration de réplication SymasLDAP où SymasLDAP se trouve sur un nœud autre que le serveur de gestion, veillez à modifier d'abord le mot de passe sur les deux nœuds SymasLDAP, puis sur les deux nœuds du serveur de gestion.
Réinitialiser le mot de passe de l'administrateur système
Pour réinitialiser le mot de passe de l'administrateur système, vous devez le réinitialiser à deux endroits :
- Serveur de gestion
- Nouvelle interface utilisateur Edge
Pour réinitialiser le mot de passe administrateur du système :
- Modifiez le fichier de configuration silencieux que vous avez utilisé pour installer la nouvelle interface utilisateur Edge afin de définir les propriétés suivantes :
APIGEE_ADMINPW=NEW_PASSWORD SMTPHOST=smtp.gmail.com SMTPPORT=465 SMTPUSER=foo@gmail.com SMTPPASSWORD=bar SMTPSSL=y SMTPMAILFROM="My Company <myco@company.com>"
Notez que vous devez inclure les propriétés SMTP lors de la transmission du nouveau mot de passe, car toutes les propriétés de la nouvelle interface utilisateur Edge sont réinitialisées.
- Sur le nœud de l'interface utilisateur New Edge, arrêtez l'interface utilisateur New Edge :
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
- Utilisez l'utilitaire
apigee-setuppour réinitialiser le mot de passe dans la nouvelle interface utilisateur Edge à partir du fichier de configuration :/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
- (Uniquement si TLS est activé sur la nouvelle interface utilisateur Edge) Réactivez TLS sur la nouvelle interface utilisateur Edge, comme décrit dans la section Configurer TLS pour la nouvelle interface utilisateur Edge.
- Sur le serveur de gestion, créez un fichier XML. Dans ce fichier, définissez l'ID utilisateur sur "admin" et définissez le mot de passe, le prénom, le nom et l'adresse e-mail au format suivant :
<User id="admin"> <Password><![CDATA[password]]></Password> <FirstName>first_name</FirstName> <LastName>last_name</LastName> <EmailId>email_address</EmailId> </User>
- Sur le serveur de gestion, exécutez la commande suivante :
curl -u "admin_email_address:admin_password" -H \ "Content-Type: application/xml" -H "Accept: application/json" -X POST \ "http://localhost:8080/v1/users/admin_email_address" -d @your_data_file
Où your_data_file correspond au fichier que vous avez créé à l'étape précédente.
Edge met à jour votre mot de passe administrateur sur le serveur de gestion.
- Supprimez le fichier XML que vous avez créé. Les mots de passe ne doivent jamais être stockés de manière permanente en texte clair.
Dans un environnement de réplication SymasLDAP avec plusieurs serveurs de gestion, la réinitialisation du mot de passe sur un serveur de gestion met automatiquement à jour les autres serveurs de gestion. Toutefois, vous devez mettre à jour tous les nœuds de la nouvelle interface utilisateur Edge séparément.
Réinitialiser le mot de passe d'un utilisateur de l'organisation
Pour réinitialiser le mot de passe d'un utilisateur de l'organisation, utilisez l'utilitaire apigee-servce pour appeler apigee-setup, comme illustré dans l'exemple suivant :
/opt/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password [-h] [-u USER_EMAIL] [-p USER_PWD] [-a ADMIN_EMAIL] [-P APIGEE_ADMINPW] [-f configFile]
Exemple :
/opt/apigee/apigee‑service/bin/apigee‑service apigee‑setup reset_user_password ‑u user@myCo.com ‑p Foo12345 ‑a admin@myCo.com ‑P adminPword
cp ~/Documents/tmp/hybrid_root/apigeectl_beta2_a00ae58_linux_64/README.md ~/Documents/utilities/README.md
Vous trouverez ci-dessous un exemple de fichier de configuration que vous pouvez utiliser avec l'option "-f" :
USER_NAME=user@myCo.com USER_PWD="Foo12345" APIGEE_ADMINPW=ADMIN_PASSWORD
Vous pouvez également utiliser l'API Update user pour modifier le mot de passe de l'utilisateur.
Règles relatives aux mots de passe des administrateurs système et des utilisateurs de l'organisation
Utilisez cette section pour appliquer un niveau de longueur et de sécurité de mot de passe souhaité pour vos utilisateurs de l'API Management. Les paramètres utilisent une série d'expressions régulières préconfigurées (et numérotées de manière unique) pour vérifier le contenu des mots de passe (par exemple, les majuscules, les minuscules, les chiffres et les caractères spéciaux). Écrivez ces paramètres dans le fichier /opt/apigee/customer/application/management-server.properties. Si ce fichier n'existe pas, créez-le.
Après avoir modifié management-server.properties, redémarrez le serveur de gestion :
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Vous pouvez ensuite définir des niveaux de sécurité des mots de passe en regroupant différentes combinaisons d'expressions régulières. Par exemple, vous pouvez déterminer qu'un mot de passe comportant au moins une lettre majuscule et une lettre minuscule obtient une note de force de "3", mais qu'un mot de passe comportant au moins une lettre minuscule et un chiffre obtient une note plus élevée de "4".
| Propriété | Description |
|---|---|
conf_security_password.validation.minimum.password.length=8 conf_security_password.validation.default.rating=2 conf_security_password.validation.minimum.rating.required=3 |
Utilisez-les pour déterminer les caractéristiques générales des mots de passe valides. La note minimale par défaut pour le niveau de sécurité du mot de passe (décrit plus loin dans le tableau) est de 3. Notez que la valeur password.validation.default.rating=2 est inférieure à la note minimale requise. Cela signifie que si un mot de passe saisi ne respecte pas les règles que vous configurez, il reçoit la note 2 et n'est donc pas valide (inférieur à la note minimale de 3). |
|
Vous trouverez ci-dessous des expressions régulières qui identifient les caractéristiques des mots de passe. Notez que chacun d'eux est numéroté. Par exemple, |
|
conf_security_password.validation.regex.1=^(.)\\1+$ |
1 : tous les caractères se répètent |
conf_security_password.validation.regex.2=^.*[a-z]+.*$ |
2) Au moins une lettre minuscule |
conf_security_password.validation.regex.3=^.*[A-Z]+.*$ |
3 : Au moins une lettre majuscule |
conf_security_password.validation.regex.4=^.*[0-9]+.*$ |
4 : au moins un chiffre |
conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$ |
5) Au moins un caractère spécial (autre que le tiret bas _) |
conf_security_password.validation.regex.6=^.*[_]+.*$ |
6 : Au moins un trait de soulignement |
conf_security_password.validation.regex.7=^.*[a-z]{2,}.*$ |
7 : plus d'une lettre minuscule |
conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$ |
8 : Plusieurs lettres majuscules |
conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$ |
9 : Plus d'un chiffre |
conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$ |
10 : plusieurs caractères spéciaux (à l'exception du trait de soulignement) |
conf_security_password.validation.regex.11=^.*[_]{2,}.*$ |
11 : Plus d'un trait de soulignement |
|
Les règles suivantes déterminent le niveau de sécurité d'un mot de passe en fonction de son contenu. Chaque règle inclut une ou plusieurs expressions régulières de la section précédente et lui attribue une force numérique. La force numérique d'un mot de passe est comparée au nombre conf_security_password.validation.minimum.rating.required en haut de ce fichier pour déterminer si un mot de passe est valide ou non. |
|
conf_security_password.validation.rule.1=1,AND,0 conf_security_password.validation.rule.2=2,3,4,AND,4 conf_security_password.validation.rule.3=2,9,AND,4 conf_security_password.validation.rule.4=3,9,AND,4 conf_security_password.validation.rule.5=5,6,OR,4 conf_security_password.validation.rule.6=3,2,AND,3 conf_security_password.validation.rule.7=2,9,AND,3 conf_security_password.validation.rule.8=3,9,AND,3 |
Chaque règle est numérotée. Par exemple, Chaque règle utilise le format suivant (à droite du signe égal) : regex-index-list,[AND|OR],rating regex-index-list correspond à la liste des expressions régulières (par numéro de la section précédente), ainsi qu'à un opérateur rating est l'évaluation numérique de la force attribuée à chaque règle. Par exemple, la règle 5 signifie que tout mot de passe comportant au moins un caractère spécial OU un trait de soulignement obtient un niveau de sécurité de 4. Avec |
conf_security_rbac.password.validation.enabled=true |
Définissez la validation du mot de passe du contrôle des accès basé sur les rôles sur "false" lorsque l'authentification unique (SSO) est activée. La valeur par défaut est "true". |
Réinitialiser le mot de passe Cassandra
Par défaut, Cassandra est fourni avec l'authentification désactivée. Si vous activez l'authentification, elle utilise un utilisateur prédéfini nommé cassandra avec le mot de passe cassandra. Vous pouvez utiliser ce compte, définir un autre mot de passe pour ce compte ou créer un utilisateur Cassandra. Ajoutez, supprimez et modifiez des utilisateurs à l'aide des instructions Cassandra CREATE/ALTER/DROP USER.
Pour savoir comment activer l'authentification Cassandra, consultez Activer l'authentification Cassandra.
Pour réinitialiser le mot de passe Cassandra, vous devez :
- Définissez le mot de passe sur n'importe quel nœud Cassandra. Il sera diffusé sur tous les nœuds Cassandra de l'anneau.
- Mettez à jour le serveur de gestion, les processeurs de messages, les routeurs, les serveurs Qpid et les serveurs Postgres sur chaque nœud avec le nouveau mot de passe.
Pour en savoir plus, consultez Commandes CQL.
Pour réinitialiser le mot de passe Cassandra :
- Connectez-vous à n'importe quel nœud Cassandra à l'aide de l'outil
cqlshet des identifiants par défaut. Il vous suffit de modifier le mot de passe sur un nœud Cassandra pour qu'il soit diffusé sur tous les nœuds Cassandra de l'anneau :/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p 'cassandra'
Où :
cassIPest l'adresse IP du nœud Cassandra.9042est le port Cassandra.- L'utilisateur par défaut est
cassandra. - Le mot de passe par défaut est "
cassandra". Si vous avez déjà modifié le mot de passe, utilisez le mot de passe actuel. Si le mot de passe contient des caractères spéciaux, vous devez l'encapsuler entre guillemets simples.
- Exécutez la commande suivante à l'invite
cqlsh>pour mettre à jour le mot de passe :ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
Si le nouveau mot de passe contient un guillemet simple, échappez-le en le faisant précéder d'un guillemet simple.
- Quittez l'outil
cqlsh:exit
- Sur le nœud du serveur de gestion, exécutez la commande suivante :
/opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p 'CASS_PASSWORD'
Vous pouvez éventuellement transmettre à la commande un fichier contenant le nouveau nom d'utilisateur et le nouveau mot de passe :
apigee-service edge-management-server store_cassandra_credentials -f configFile
Où configFile contient les éléments suivants :
CASS_USERNAME=CASS_USERNAME CASS_PASSWORD='CASS_PASSWROD'
Cette commande redémarre automatiquement le serveur de gestion.
- Répétez l'étape 4 sur :
- Tous les processeurs de messages
- Tous les routeurs
- Tous les serveurs Qpid (edge-qpid-server)
- Serveurs Postgres (edge-postgres-server)
Le mot de passe Cassandra est désormais modifié.
Réinitialiser le mot de passe PostgreSQL
Par défaut, deux utilisateurs sont définis dans la base de données PostgreSQL : postgres et apigee.
Les deux utilisateurs ont un mot de passe par défaut de postgres. Pour modifier le mot de passe par défaut, procédez comme suit :
Modifiez le mot de passe sur tous les nœuds maîtres Postgres. Si vous avez configuré deux serveurs Postgres en mode maître/veille, il vous suffit de modifier le mot de passe sur le nœud maître. Pour en savoir plus, consultez Configurer la réplication maître-serveur de secours pour Postgres .
- Sur le nœud maître Postgres, remplacez les répertoires par
/opt/apigee/apigee-postgresql/pgsql/bin. - Définissez le mot de passe de l'utilisateur PostgreSQL
postgres:- Connectez-vous à la base de données PostgreSQL à l'aide de la commande suivante :
psql -h localhost -d apigee -U postgres
- Lorsque vous y êtes invité, saisissez le mot de passe de l'utilisateur
postgresexistant en tant quepostgres. - À l'invite de commande PostgreSQL, saisissez la commande suivante pour modifier le mot de passe par défaut :
ALTER USER postgres WITH PASSWORD 'new_password';
En cas de réussite, PostgreSQL renvoie la réponse suivante :
ALTER ROLE
- Quittez la base de données PostgreSQL à l'aide de la commande suivante :
\q
- Connectez-vous à la base de données PostgreSQL à l'aide de la commande suivante :
- Définissez le mot de passe de l'utilisateur PostgreSQL
apigee:- Connectez-vous à la base de données PostgreSQL à l'aide de la commande suivante :
psql -h localhost -d apigee -U apigee
- Lorsque vous y êtes invité, saisissez le mot de passe de l'utilisateur
apigeeen tant quepostgres. - À l'invite de commande PostgreSQL, saisissez la commande suivante pour modifier le mot de passe par défaut :
ALTER USER apigee WITH PASSWORD 'new_password';
- Quittez la base de données PostgreSQL à l'aide de la commande suivante :
\q
Vous pouvez définir les mots de passe des utilisateurs
postgresetapigeesur la même valeur ou sur des valeurs différentes. - Connectez-vous à la base de données PostgreSQL à l'aide de la commande suivante :
- Définissez
APIGEE_HOME:export APIGEE_HOME=/opt/apigee/edge-postgres-server
- Chiffrez le nouveau mot de passe :
sh /opt/apigee/edge-analytics/utils/scripts/utilities/passwordgen.sh new_password
Cette commande renvoie un mot de passe chiffré. Le mot de passe chiffré commence après le caractère ":" et ne l'inclut pas. Par exemple, le mot de passe chiffré pour "apigee1234" est le suivant :
Encrypted string:WheaR8U4OeMEM11erxA3Cw==
- Mettez à jour le nœud du serveur de gestion avec les nouveaux mots de passe chiffrés pour les utilisateurs
postgresetapigee.- Sur le serveur de gestion, accédez au répertoire
/opt/apigee/customer/application. - Modifiez le fichier
management-server.propertiespour définir les propriétés suivantes. Si ce fichier n'existe pas, créez-le. - Assurez-vous que le fichier appartient à l'utilisateur
apigee:chown apigee:apigee management-server.properties
- Sur le serveur de gestion, accédez au répertoire
- Mettez à jour tous les nœuds de serveur Postgres et de serveur Qpid avec le nouveau mot de passe chiffré.
- Sur le nœud du serveur Postgres ou du serveur Qpid, accédez au répertoire suivant :
/opt/apigee/customer/application
- Ouvrez les fichiers suivants pour les modifier :
postgres-server.propertiesqpid-server.properties
Si ces fichiers n'existent pas, créez-les.
- Ajoutez les propriétés suivantes aux fichiers :
conf_pg-agent_password=newEncryptedPasswordForPostgresUserconf_pg-ingest_password=newEncryptedPasswordForPostgresUserconf_query-service_pgDefaultPwd=newEncryptedPasswordForPostgresUserconf_query-service_dwDefaultPwd=newEncryptedPasswordForPostgresUserconf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
- Assurez-vous que les fichiers appartiennent à l'utilisateur
apigee:chown apigee:apigee postgres-server.properties
chown apigee:apigee qpid-server.properties
- Sur le nœud du serveur Postgres ou du serveur Qpid, accédez au répertoire suivant :
- Redémarrez les composants suivants dans l'ordre indiqué :
- Base de données PostgreSQL :
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Serveur Qpid :
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
- Serveur Postgres :
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
- Serveur de gestion :
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- Base de données PostgreSQL :