Servicios

Clave unica

Creación de URI principal

Método: GET
Ruta: https://accounts.claveunica.gob.cl/openid/authorize/
Parámetros:
client_id: Identificador de la integración. Credencial solicitada a la secretaría del Estado.
response_type: Misma lógica de la capa OpenID Connect del protocolo OAuth 2.0, en el cual este parámetro recibe un código de autorización de un solo uso, que luego es intercambiado por un "token de acceso".
scope: Permite obtener la información del ciudadano (run y nombre completo). Debe ser openid run name.
redirect_uri: En este parámetro va la URI de la aplicación a la que estamos integrando con ClaveÚnica.
state: Token de inicio de sesión. \

Ejemplos de URI compuesta:

https://accounts.claveunica.gob.cl/openid/authorize/?client_id=Wbgx7HkjoeU6uarez3uYnn41V mGkd600&response_type=code&scope=openid run name&redirect_uri=https%3A%2F%2Fintegrador.cl%2Fcallback&state=abcdefgh

Explicación de uso:

Este endpoint es usado para el comienzo del proceso de autorización de la solicitud (como bien dice la propia ruta), generando una URI que será aquella que, mediante la generación de tokens de acceso, nos dará acceso al endpoint de solicitud de información del ciudadano.

---

Consultar información ciudadano

Método: POST
Ruta: https://accounts.claveunica.gob.cl/openid/userinfo/

Ejemplo de solicitud y respuesta:

curl -i https://accounts.claveunica.gob.cl/openid/userinfo/ -X POST -H "authorization: Bearer 2718e590ec7e47858e4af5922050d28b" JavaScript

{ 
	"sub": "1234567",
	"RolUnico": {
		"DV": "9",
		"numero": 12345678,
		"tipo": "RUN"
	}, 
	"name": {
		"apellidos": [
			 "Del Río",
			"Gonzalez"
		], 
		"nombres": [ 
			"María",
			"Carmen"
		] 
	} 
}

Explicación de uso:

Es el endpoint que más queremos usar pues es mediante el cual consultamos y creamos una estructura json donde tendremos los datos de los usuarios que hayan decidido realizar la firma digital mediante ClaveÚnica.

---

Diagrama de secuencia de interacción completa con API