Reporte de Crédito de personas naturales y jurídicas que considera fuentes públicas y privadas.
PHP 7.1 ó superior
- 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
Ejecutar: composer install
- Se tiene que 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}
- Iniciar sesión.
- Dar clic en la sección "Mis aplicaciones".
- Seleccionar la aplicación.
- Ir a la pestaña de "Certificados para @tuApp".
- Al abrirse la ventana, seleccionar el certificado previamente creado y dar clic en el botón "Cargar":
- Iniciar sesión.
- Dar clic en la sección "Mis aplicaciones".
- Seleccionar la aplicación.
- Ir a la pestaña de "Certificados para @tuApp".
- Al abrirse la ventana, dar clic al botón "Descargar":
Es importante que este contenedor sea almacenado en la siguiente ruta: /path/to/repository/lib/Interceptor/keypair.p12
Así mismo el certificado proporcionado por Círculo de Crédito en la siguiente ruta: /path/to/repository/lib/Interceptor/cdc_cert.pem
- En caso de que no se almacene así, se debe especificar la ruta donde se encuentra el contenedor y el certificado. Ver el siguiente ejemplo:
$password = getenv('KEY_PASSWORD');
$this->signer = new KeyHandler(
"/example/route/keypair.p12",
"/example/route/cdc_cert.pem",
$password
);
NOTA: Solamente en caso de que el contenedor se haya cifrado, debe colocarse la contraseña en una variable de ambiente e indicar el nombre de la misma, como se ve en la imagen anterior.
Modificar la URL y las credenciales de acceso a la petición en test/Api/ApiTest.php, como se muestra en el siguiente fragmento de código:
public function setUp()
{
$password = getenv('KEY_PASSWORD');
$this->signer = new KeyHandler(null, null, $password);
$events = new MiddlewareEvents($this->signer);
$handler = handlerStack::create();
$handler->push($events->add_signature_header('x-signature'));
$handler->push($events->verify_signature_header('x-signature'));
$client = new Client(['handler' => $handler]);
$config = new Configuration();
$config->setHost('the_url');
$this->apiInstance = new Instance($client, $config);
$this->x_api_key = "your_api_key";
$this->username = "your_username";
$this->password = "your_password";
}
Es importante contar con el setUp() que se encargará de firmar y verificar la petición.
NOTA: Los datos de la siguiente petición son solo representativos.
public function testGetRC()
{
$request = new \rc\pe\Client\Model\Peticion();
$request->setFolio("10000200");
$request->setNumeroDocumento("67544489");
$request->setTipoDocumento("1");
try {
$result = $this->apiInstance->getRC($this->x_api_key, $this->username, $this->password, $request);
if($this->apiInstance->getStatusCode() == 200){
print_r($result);
}
} catch (ApiException $e) {
if($e->getCode() !== 204){
echo ' code. Exception when calling ApiTest->getRC: ', $e->getResponseBody(), PHP_EOL;
}
}
$this->assertTrue($this->apiInstance->getStatusCode() == 200);
}
Para ejecutar las pruebas unitarias:
./vendor/bin/phpunit