Parametri di richiesta delle applicazioni

Un’applicazione può fornire valori alle trasformazioni dei claim, ad esempio un ID profilo o un elenco di reparti. Configura Allowed request parameters nella registrazione dell’applicazione per rendere disponibili i valori selezionati come claim _local:params:{name}.

Configurare i parametri

Attiva Show advanced e configura Allowed request parameters nella registrazione dell’applicazione.

Aggiungi ogni nome di parametro consentito. L’elenco è vuoto per impostazione predefinita. I nomi vengono salvati in minuscolo; usa trattini bassi tra le parole, ad esempio profile_id.

FoxIDs suddivide automaticamente i valori dei parametri in corrispondenza degli spazi. Un valore senza spazi produce un claim; un elenco separato da spazi produce un claim per elemento. I valori mantengono le maiuscole e le minuscole. Ad esempio:

profile_id=16b66fb6-9f88-4a10-b489-8e54f48f76a4&departments=Sales%20Support

Quando profile_id e departments sono configurati come nomi di parametri consentiti, le trasformazioni ricevono:

_local:params:profile_id = 16b66fb6-9f88-4a10-b489-8e54f48f76a4
_local:params:departments = Sales
_local:params:departments = Support

Gli spazi iniziali, finali e ripetuti vengono ignorati. Le virgolette non hanno un significato speciale. Invia l’elenco in una sola occorrenza del parametro.

Richieste supportate

Lo scambio del codice di autorizzazione e le richieste con refresh token usano i claim del grant esistente; gli ulteriori parametri di richiesta non vengono resi disponibili alle trasformazioni.

Per SAML, invia i parametri insieme al messaggio del protocollo. Con HTTP-Redirect, aggiungili dopo aver creato l’URL di reindirizzamento firmato, in modo che il messaggio SAML e la firma rimangano intatti. Questi parametri aggiuntivi si trovano all’esterno del messaggio SAML firmato.

Limiti

I nomi dei parametri vengono confrontati senza distinguere maiuscole e minuscole. I nomi non configurati vengono ignorati. I parametri configurati devono comparire una sola volta e contenere valori che non siano vuoti né composti esclusivamente da caratteri di spaziatura. Un parametro ripetuto, incluso lo stesso nome sia nella query sia nel modulo, o un valore che supera i limiti causa il rifiuto della richiesta con un errore di protocollo. I separatori degli elenchi non vengono conteggiati nella lunghezza complessiva dei valori.

Usare i parametri nelle trasformazioni

Durante l’accesso nel browser, i parametri sono disponibili a partire dalle trasformazioni dei claim di primo livello del metodo di autenticazione. Rimangono disponibili nei successivi insiemi di trasformazioni, inclusi Extended UI e le trasformazioni dell’applicazione, per l’intero flusso di accesso. Ogni insieme riceve i valori accettati in origine come claim locali.

Usa una trasformazione Map per copiare un valore in un claim ordinario da emettere o in un claim _internal: per elaborazioni successive. Per conservare una selezione autorizzata per i successivi accessi alle applicazioni, mappala a un claim _session: nel metodo di autenticazione. Un accesso successivo può usare il parametro fornito o, se assente, il claim di sessione salvato. Vedi claim locali, interni e di sessione.

I parametri sono dati di input forniti dal chiamante. Prima di usare un ID profilo per l’impersonificazione o un’altra operazione privilegiata, verifica le autorizzazioni dell’utente autenticato e l’idoneità dell’utente di destinazione. Un ID fornito identifica la destinazione richiesta; non autorizza l’accesso. Evita di inviare segreti nei parametri di query.

Documentazione correlata

• Attività di trasformazione dei claim
• Applicazioni OpenID Connect
• Applicazioni SAML 2.0
• Applicazioni OAuth 2.0
• Configurazione delle applicazioni tramite Control API