rnp_ffi_set_pass_provider

(PECL rnp >= 0.1.1)

rnp_ffi_set_pass_provider — Définit la fonction de rappel du fournisseur de mot de passe

Description

rnp_ffi_set_pass_provider(RnpFFI $ffi, callable $password_callback): bool

Définit la fonction de rappel du fournisseur de mot de passe. Cette fonction peut demander le mot de passe sur une entrée standard (si le script PHP est exécuté dans un environnement de ligne de commande), afficher une boîte de dialogue GUI ou fournir le mot de passe de toutes les manières possibles. Les mots de passe demandés sont utilisés pour chiffrer ou déchiffrer les clés secrètes ou effectuer des opérations de chiffrement/déchiffrement symétriques.

Liste de paramètres

ffi

L'objet FFI retourné par rnp_ffi_create().

password_callback

La fonction qui doit être appelée pour chaque demande de mot de passe. Elle a la signature suivante:

password_callback(string $key_fp, string $pgp_context, string &$password): bool

$key_fp - L'empreinte de la clé, le cas échéant. Peut être vide.
$pgp_context - Chaîne décrivant pourquoi la clé est demandée.
$password - Référence de chaîne où le mot de passe fourni doit être stocké.

La fonction de rappel doit retourner true si le mot de passe a été défini avec succès ou false si une erreur survient.

Valeurs de retour

Renvoie true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple d'une fonction de rappel simple

<?php
function password_callback(string $key_fp, string $pgp_context, string &$password)
{
    $password = "password";

    return true;
}

$ffi = rnp_ffi_create('GPG', 'GPG');

rnp_ffi_set_pass_provider($ffi, 'password_callback');