Prerequisiti e Configurazione
Prerequisiti e Configurazione
Prima di configurare il tuo provider di identità, completa i prerequisiti di seguito. Il tuo rappresentante Deque può aiutarti a fornire l'abbonamento SCIM e generare la tua chiave API.
Prerequisiti
Abbonamento SCIM
Il tuo account entreprise axe deve avere un Abbonamento SCIM attivo. Senza di esso, le richieste SCIM restituiscono:
402 "Subscription required"Contatta il tuo rappresentante Deque per aggiungere l'abbonamento SCIM alla tua entreprise.
SCIM funziona insieme al Single Sign-On. Quando SCIM fornisce un utente nuovo, l'account è collegato al provider di identità della tua organizzazione così l'utente può accedere.
Generazione di una chiave API SCIM
Il tuo provider di identità si autentica con axe utilizzando un Chiave API SCIM applicato alla tua enterprise.
- Accedi al Portale Account axe come amministratore.
- Vai a Impostazioni > Gestisci Chiavi API.
- Genera un Chiave API SCIM nuovo.
- Copia la chiave e conservala in sicurezza — la inserirai nel connettore SCIM del tuo provider di identità.
Tratta la chiave API come una password. Condividila solo tramite un canale sicuro (ad esempio, il gestore dei segreti della tua organizzazione), mai via email o chat in chiaro. Se una chiave viene esposta, revocala e generane una nuova.
URL di base
Usa l'URL di base per la tua regione o istanza privata:
| Ambiente | URL di base |
|---|---|
| USA (SaaS) | https://axe.deque.com |
| Parigi (SaaS) | https://axe-eu.deque.com |
| Australia (SaaS) | https://axe-au.deque.com |
| Francoforte (SaaS) | https://axe-frankfurt.deque.com |
| Cloud privato / on-prem | Il tuo URL dell'istanza dedicata |
Gli endpoint SCIM sono serviti sotto il percorso /api/scim/v2 — per esempio:
https://axe.deque.com/api/scim/v2/UsersAutenticazione
Includi la chiave API in ogni richiesta. Entrambi i seguenti sono accettati:
# Preferred
-H "X-API-Key: <API_KEY>"
# Also accepted (with or without a "Bearer " prefix)
-H "Authorization: <API_KEY>"Successivo
Una volta soddisfatti i prerequisiti e ottenuta la tua chiave API e l'URL di base, continua a Configurazione del tuo Provider di Identità.