...

Tout ces attributs peuvent être indiquer en variable d'environnement en les mettant en majuscules et en prefixant le nom avec GLDGDD_

Les variables d'environnement sont prioritaires sur le fichier de configuration

Exemple : GLD GDD_RABBITMQ_HOST

L'environnement utilisé est défini par la variable d'environnement GORGGOOGLE_LDAPDIRECTORY_DAEMON_ENV et à pour valeur "development" par défaut

La variable d'environnement LOGGER_LEVEL logger_level permet de définir la verbosité des logs. Les valeurs autorisées sont :

• DEBUG - valeur par défaut
• INFO
• WARN
• ERROR
• FATAL

Pour fonctionner les API google on besoin d'un json appelé client_secret.json.

Ce fichier est stocké dans le dossier secrets/

Il est également possible de stocker le JSON dans la variable d'environnement GDD_GOOGLE_CLIENT_SECRET

Si la variable d'environnement REDIS_URL est définie l'appli stockera les token de connexion dans le Redis, sinon ils  seront stocké dans secrets/tokens.yaml

Arret / Démarage

Sur Heroku :

Il suffit d'activer ou désactiver le dyno workerSuivre la procédure Démarrer/Arrêter une application sur Heroku

En local :

Lancer l'executable bin/worker pour démarrer le service

Ctrl+C pour le couper ou envoyer SIGINT (kill -2)

Accéder aux Logs

Suivre la procédure Accéder aux logs d'une application Heroku

Installation

Infos pour les Dev'

...

{
	"quoiuuid": "Objet contenu dans l'attribut 'data' du message"4fa874db-7730-4105-b550-8ea991907240",
    "google_id": "123465789123034"
}

{
	"uuid": "4fa874db-7730-4105-b550-8ea991907240",
    "format"google_id": "123465789123034"
}

{
	"key": "JSON4fa874db-7730-4105-b550-8ea991907240"
}

...

{  
   "$schema":"http://json-schema.org/draft-04/schema#",
   "title":"Create Google Account message schema",
   "type":"object",
   "properties":{  
      "gram_account_uuid":{  
         "type":"string",
         "description":"The unique identifier of linked GrAM Account",
         "pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"
      },
      "primary_email":{  
         "type":"string",
         "description":"Primary email address used to create google account"
      },
      "aliases":{  
         "type":"array",
         "description":"Google account email aliases",
         "items":{  
            "type":"string"
         }
      }
   },
   "additionalProperties":true,
   "required":[  
      "gram_account_uuid",
      "primary_email"
   ]
}

{
	"quoi": "Objet contenu dans l'attribut 'data' du message"  "gram_account_uuid":"36a7e016-a300-4f52-85f4-6804dede6c6b",
  "primary_email":"[email protected]",
  "aliases":[]
}

{  
   "$schema":"http://json-schema.org/draft-04/schema#",
   "title":"Update Google Account message schema",
   "type":"object",
   "properties":{  
      "gram_account_uuid":{  
         "type":"string",
         "description":"The unique identifier of linked GrAM Account",
         "pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"
      },
      "primary_email":{  
         "type":"string",
         "description":"Primary email address uof google account"
      },
      "aliases":{  
         "type":"array",
    "format": "JSON     "description":"Google account email aliases",
         "items":{  
            "type":"string"
         }
      }
   },
   "additionalProperties":true,
   "required":[  
      "gram_account_uuid"
   ]
}

{
  "gram_account_uuid":"36a7e016-a300-4f52-85f4-6804dede6c6b",
  "aliases":[]
}

{
  "google_account_key":"123465789123034"
}

...

Codes erreurs

Erreur lors de la validation des données

Le message est compris mais ne correspond pas au schéma attendu.

Réponse
Status: Hardfail
Code erreur : 422 - Unprocessable Entity
Nom de l'erreur : InvalidPayload
Données :

• DOIT contenir les erreurs par rapport au schema
• PEUT contenir le schéma attendu

Identifiant google déjà enregistré dans le GrAM

Le compte GrAM contient déjà un identifiant Google et cet identifiant renvoie sur un compte existant.
Dans le cas d'utilisation par GorgMai, un membre du support doit intervenir pour vérifier que ce compte est bien celui de l'utilisateur. Si c'est le cas il modiie les alias afin de correspondre aux données de GorgMail. Si ce n'est pas le cas il doit supprimer l'identifiant dans le GrAM afin de relancer la procedure et créer un nouveau compte.

Réponse
Status: Hardfail
Code erreur : 409 - Conflict
Nom de l'erreur : GoogleAccountAlreadyRegisteredInGram
Données :

• DOIT contenir les infos du compte google enregistré dans GrAM :
  • L'identifiant Google (numérique)
  • L'adresse principale
  • Le prenom
  • Le nom
  • Le UUID de l'utilisateur si celui ci est energistré chez Google

Notes
Si un compte GrAM contient déjà un identifiant Google mais que cet identifiant ne correspond pas à un compte Google existant, il est ignoré et écrasé par le compte Google nouvellement créé.

Adresse principale déjà enregistrée chez Google

Le compte google ne peut pas être créé car un compte google existe déjà avec cette adresse. Il peut s'agir d'une adresse principale ou d'un alias. Cette erreur est grave car elle signifie qu'une adresse Gadz.org a été réattribué et une intervention humaine est nécessaire pour rétablir l'unicité des adresses Gadz.org

Réponse
Status: Hardfail
Code erreur : 409 - Conflict
Nom de l'erreur : GoogleAccountAlreadyExists
Données :

• DOIT contenir les infos du compte google en doublon
  • L'identifiant Google (numérique)
  • L'adresse principale
  • Le prenom
  • Le UUID de l'utilisateur si celui ci est energistré chez Google
  • Le nom

Erreur lors de l'execution.

Une erreur est apparu pendant l'execution du code. Il peut s'agir d'une erreur prévu ou non.

Réponse
Status: Hardfail
Code erreur : 500 - InternalError
Nom de l'erreur : Par défaut "InternalError"
Données :

• DOIT contenir l'état du compte Google et ses données d'identifications
• DOIT contenir le nom de l'erreur interne ayant été levé
• PEUT contenir des données de debug

Cas particulier : Erreur lors de la mise à jour du compte GrAM

Il s'agit d'une erreur facilement identifiable. Généralement, elle apparaît lorsqu'un compte gram a été enregistré de force avec des données invalides et refuse ainsi toute mise à jour tant que les données invalides ne sont pas corrigées. Si ce bug apparaît, le compte google a bien été créé mais il n'est pas lié avec le compte GrAM. Une correction manuelle est nécessaire et l'enregistrement du compte google dans le GrAM doit être réalisé manuellement.

Données supplémentaires à inclure dans le debug :

• Les données du compte GrAM à enregistrer (en prenant soin de supprimer le hash du mot de passe)