dataStore.provideDataKey( )

4D v18

Description

La méthode dataStore.provideDataKey( ) permet de fournir une clé de chiffrement des données pour le fichier de données courant du datastore et détecte si la clé correspond aux données chiffrées. Cette commande peut être utilisée à l'ouverture d'une base chiffrée, ou à l'exécution de n'importe quelle opération de chiffrement qui nécessite la clé de chiffrement, telle que le rechiffrement du fichier de données.

Notes :

La méthode dataStore.provideDataKey( ) doit être appelée dans une base chiffrée. Si elle est appelée dans une base non chiffrée, l'erreur 2003 (la clé de chiffrement ne correspond pas aux données) est retournée. Utilisez la commande Data file encryption status pour déterminer si la base est chiffrée.
La méthode dataStore.provideDataKey( ) ne peut pas être appelée à partir d'un 4D distant.

Passez le paramètre phraseSecrèteCour ou cléDonnéesCour qui correspond à la base :

phraseSecrèteCour : Chaine utilisée pour générer la clé de chiffrement des données. Lorsque vous utilisez ce paramètre, une clé de chiffrement est générée.
cléDonnéesCour : Objet (avec la propriété encodedKey) contenant la clé de chiffrement des données. Cette clé peut avoir été générée à l'aide de la commande New data key.

Si une clé de chiffrement des données valide est fournie, elle est ajoutée à keyChain dans la mémoire et active le mode chiffrement :

toutes les modifications de données apportées dans des tables chiffrables sont chiffrées sur le disque (fichiers .4DD, .journal. 4Dindx)
toutes les données chargées à partir de tables chiffrables sont déchiffrées dans la mémoire

Résultat

Le résultat de la commande est décrit dans l'objet retourné :

Propriété		Type	Description
success		Booléen	Vrai si la clé de chiffrement fournie correspond aux données chiffrées, sinon Faux

			Les propriétés ci-dessous sont retournées uniquement si success est mis à FAUX
status		Numérique	Code d'erreur (4 si la clé de chiffrement fournie est mauvaise)
statusText		Texte	Message d'erreur
errors		Collection	Pile d'erreurs. La première erreur possède l'indice le plus élevé
	[ ].componentSignature	Texte	Nom du composant interne
	[ ].errCode	Numérique	Numéro de l'erreur
	[ ].message	Texte	Message d'erreur

Si aucun paramètre phraseSecrèteCour ou cléDonnéesCour n'est fourni, dataStore.provideDataKey( ) retourne null (aucune erreur n'est générée).

Exemple

 C_OBJECT($keyStatus)

 C_TEXT($passphrase)

 

 $passphrase:=Request("Saisissez la phrase secrète")

 If(OK=1)

    $keyStatus:=ds.provideDataKey($passphrase)

    If($keyStatus.success)

       ALERT("Vous avez fourni une clé de chiffrement valide")

    Else

       ALERT("Vous n'avez pas fourni une clé de chiffrement valide, vous ne pourrez pas utiliser des données chiffrées")

    End if

 End if

Voir aussi

Data file encryption status
Encrypt data file
New data key