redgirasol / signature-manager
There is no license information available for the latest version (2.0.3) of this package.
2.0.3
2023-08-16 19:50 UTC
Requires
- php: >=8.0
- monolog/monolog: ^3.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ~2.12
- phpunit/phpunit: ^9.0
- squizlabs/php_codesniffer: ~2.6
This package is not auto-updated.
Last update: 2025-03-28 01:55:42 UTC
README
Requisitos
PHP 7.1 ó superior
Dependencias adicionales
- Se debe contar con las siguientes dependencias de PHP:
- ext-curl
- ext-mbstring
- En caso de no ser así, para linux use los siguientes comandos
#ejemplo con php en versión 7.3 para otra versión colocar php{version}-curl
apt-get install php7.3-curl
apt-get install php7.3-mbstring
- Composer vea como instalar
Instalación
Ejecutar: composer install
Guía de inicio
Paso 1. Generar llave y certificado
- Es requerido tener un contenedor en formato PKCS12.
- En caso de no contar con uno, ejecutar las instrucciones contenidas en lib/Interceptor/key_pair_gen.sh o con los siguientes comandos.
Opcional: Para cifrar el contenedor, colocar una contraseña en una variable de ambiente.
export KEY_PASSWORD=your_password
- Definir los nombres de archivos y alias.
export PRIVATE_KEY_FILE=pri_key.pem export CERTIFICATE_FILE=certificate.pem export SUBJECT=/C=MX/ST=MX/L=MX/O=CDC/CN=CDC export PKCS12_FILE=keypair.p12 export ALIAS=circulo_de_credito
- Generar llave y certificado.
#Genera la llave privada. openssl ecparam -name secp384r1 -genkey -out ${PRIVATE_KEY_FILE} #Genera el certificado público. openssl req -new -x509 -days 365 \ -key ${PRIVATE_KEY_FILE} \ -out ${CERTIFICATE_FILE} \ -subj "${SUBJECT}"
- Generar contenedor en formato PKCS12.
# Genera el archivo pkcs12 a partir de la llave privada y el certificado. # Deberá empaquetar la llave privada y el certificado. openssl pkcs12 -name ${ALIAS} \ -export -out ${PKCS12_FILE} \ -inkey ${PRIVATE_KEY_FILE} \ -in ${CERTIFICATE_FILE} -password pass:${KEY_PASSWORD}
Paso 2. Modificar configuración de la prueba
Modificar las credenciales de acceso a la petición en test/Api/SignatureTest.php, como se muestra en el siguiente fragmento de código:
public function setUp() { $this->cadena = 'XXXXXXX'; $this->signature = null; $this->signer = null; $this->valida = null; $this->keypair = '/path/to/keypair.pkcs12'; $this->cert = '/path/to/certificate.pem'; $this->password = getenv('KEY_PASSWORD'); }
Pruebas unitarias
Para ejecutar las pruebas unitarias use el siguiente comando:
./vendor/bin/phpunit