Interface UtenzeApi

public interface UtenzeApi

Fornisce identità verificate e le informazioni minime degli account necessarie ai moduli PICUS. Il chiamante applica i controlli di titolarità, assegnazione o ricezione sulla propria risorsa.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	UtenzeApi.AccountSintetico	Riferimento minimo a un account, utilizzabile nelle selezioni e negli storici.
static final record	UtenzeApi.IdentitaAutenticata	Identità di chi esegue un caso d'uso.
static final record	UtenzeApi.ProfiloErogatore	Dati di profilo utilizzati dal Catalogo per individuare gli erogatori compatibili.
static enum	UtenzeApi.RuoloUtente	Ruoli di accesso a PICUS.
static enum	UtenzeApi.StatoUtenza	Stati di abilitazione dell'account, allineati alla persistenza di Utenze.
static enum	UtenzeApi.TipoErogatore	Tipologie di erogatore rilevanti per la ricerca del Banco.

Method Summary

Modifier and Type	Method	Description
Optional<UtenzeApi.AccountSintetico>	cercaAccount(UUID accountId)	Cerca i dati minimi di un account anche per visualizzare un riferimento storico.
Optional<UtenzeApi.ProfiloErogatore>	cercaProfiloErogatoreAttivo(UUID accountId)	Cerca il profilo di un soggetto abilitato a erogare, per esempio di una OPT con un'offerta.
List<UtenzeApi.AccountSintetico>	elencoAccountAttivi(UtenzeApi.RuoloUtente ruolo)	Elenca gli account attivi di un ruolo per risolvere una selezione di destinatari.
List<UtenzeApi.ProfiloErogatore>	elencoOperatoriAttiviPerMisura(long misuraId)	Elenca gli operatori attivi del Banco il cui profilo comprende la misura indicata.
Optional<UtenzeApi.IdentitaAutenticata>	verificaAccountSessione(UUID accountId)	Conferma l'identità associata a una sessione valida, verificando lo stato corrente dell'account.
Optional<UtenzeApi.IdentitaAutenticata>	verificaCredenziali(String email, String password)	Verifica le credenziali per l'apertura di una sessione di un account attivo.

Method Details

verificaCredenziali

Optional<UtenzeApi.IdentitaAutenticata> verificaCredenziali(String email,
 String password)

Verifica le credenziali per l'apertura di una sessione di un account attivo.

Parameters:

email - indirizzo presentato per l'accesso

password - credenziale da verificare

Returns:

identità verificata oppure vuoto per credenziali errate o account non attivo

verificaAccountSessione

Optional<UtenzeApi.IdentitaAutenticata> verificaAccountSessione(UUID accountId)

Conferma l'identità associata a una sessione valida, verificando lo stato corrente dell'account.

Parameters:

accountId - identificativo ricavato dal server dalla sessione, dopo la sua verifica

Returns:

identità corrente oppure vuoto se l'account non è più attivo o non esiste

cercaAccount

Optional<UtenzeApi.AccountSintetico> cercaAccount(UUID accountId)

Cerca i dati minimi di un account anche per visualizzare un riferimento storico.

Parameters:

accountId - identificativo dell'account da consultare

Returns:

account sintetico, oppure vuoto se l'identificativo è sconosciuto

elencoAccountAttivi

List<UtenzeApi.AccountSintetico> elencoAccountAttivi(UtenzeApi.RuoloUtente ruolo)

Elenca gli account attivi di un ruolo per risolvere una selezione di destinatari.

Parameters:

ruolo - categoria degli account da cercare

Returns:

account attivi della categoria, eventualmente nessuno

cercaProfiloErogatoreAttivo

Optional<UtenzeApi.ProfiloErogatore> cercaProfiloErogatoreAttivo(UUID accountId)

Cerca il profilo di un soggetto abilitato a erogare, per esempio di una OPT con un'offerta.

Parameters:

accountId - identificativo dell'account organizzativo o personale

Returns:

profilo minimo, oppure vuoto se l'account manca, non è attivo o non è un erogatore

elencoOperatoriAttiviPerMisura

List<UtenzeApi.ProfiloErogatore> elencoOperatoriAttiviPerMisura(long misuraId)

Elenca gli operatori attivi del Banco il cui profilo comprende la misura indicata.

Parameters:

misuraId - identificativo della misura di Catalogo

Returns:

profili degli operatori compatibili con la misura, eventualmente nessuno