Funzione EncryptMessage (Kerberos)
La funzione EncryptMessage (Kerberos) crittografa un messaggio per fornire la privacy. EncryptMessage (Kerberos) consente a un'applicazione di scegliere tra gli algoritmi di crittografia supportati dal meccanismo scelto. La funzione EncryptMessage (Kerberos) usa il contesto di sicurezza a cui fa riferimento l'handle di contesto. Alcuni pacchetti non hanno messaggi da crittografare o decrittografare, ma forniscono invece un hash di integrità che può essere controllato.
Nota
EncryptMessage (Kerberos) e DecryptMessage (Kerberos) possono essere chiamati contemporaneamente da due thread diversi in un unico contesto SSPI ( Security Support Provider Interface ) se un thread esegue la crittografia e l'altro sta decrittografando. Se più thread crittografa o più thread decrittografa, ogni thread deve ottenere un contesto univoco.
Sintassi
SECURITY_STATUS SEC_Entry EncryptMessage(
_In_ PCtxtHandle phContext,
_In_ ULONG fQOP,
_Inout_ PSecBufferDesc pMessage,
_In_ ULONG MessageSeqNo
);
Parametri
-
phContext [in]
-
Handle per il contesto di sicurezza da usare per crittografare il messaggio.
-
fQOP [in]
-
Flag specifici del pacchetto che indicano la qualità della protezione. Un pacchetto di sicurezza può usare questo parametro per abilitare la selezione di algoritmi di crittografia.
Questo parametro può essere il flag seguente.
Valore Significato SECQOP_WRAP_NO_ENCRYPT Produrre un'intestazione o un trailer ma non crittografare il messaggio.
Nota: KERB_WRAP_NO_ENCRYPT ha lo stesso valore e lo stesso significato. -
pMessage [in, out]
-
Puntatore a una struttura SecBufferDesc . In input, la struttura fa riferimento a una o più strutture SecBuffer che possono essere di tipo SECBUFFER_DATA. Tale buffer contiene il messaggio da crittografare. Il messaggio viene crittografato sul posto, sovrascrivendo il contenuto originale della struttura.
La funzione non elabora i buffer con l'attributo SECBUFFER_READONLY.
La lunghezza della struttura SecBuffer che contiene il messaggio non deve essere maggiore di cbMaximumMessage, ottenuta dalla funzione QueryContextAttributes (Kerberos) (SECPKG_ATTR_STREAM_SIZES).
Le applicazioni che non usano SSL devono fornire un secBuffer di tipo SECBUFFER_PADDING.
-
MessageSeqNo [in]
-
Numero di sequenza assegnato dall'applicazione di trasporto al messaggio. Se l'applicazione di trasporto non gestisce i numeri di sequenza, questo parametro deve essere zero.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce SEC_E_OK.
Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il buffer di output è troppo piccolo. Per altre informazioni, vedere la sezione Osservazioni. |
|
L'applicazione fa riferimento a un contesto già chiuso. Un'applicazione scritta correttamente non deve ricevere questo errore. |
|
La crittografia scelta per il contesto di sicurezza non è supportata. |
|
Memoria insufficiente per completare l'azione richiesta. |
|
Handle di contesto non valido specificato nel parametro phContext . |
|
Non è stato trovato alcun buffer di tipo SECBUFFER_DATA. |
|
Né la riservatezza né l'integrità sono supportate dal contesto di sicurezza. |
Commenti
La funzione EncryptMessage (Kerberos) crittografa un messaggio in base al messaggio e alla chiave di sessione da un contesto di sicurezza.
Se l'applicazione di trasporto ha creato il contesto di sicurezza per supportare il rilevamento della sequenza e il chiamante fornisce un numero di sequenza, la funzione include queste informazioni con il messaggio crittografato. L'inclusione di queste informazioni protegge dalla riproduzione, dall'inserimento e dall'eliminazione dei messaggi. Il pacchetto di sicurezza incorpora il numero di sequenza passato dall'applicazione di trasporto.
Nota
Questi buffer devono essere specificati nell'ordine indicato.
| Tipo di buffer | Descrizione |
|---|---|
| SECBUFFER_STREAM_HEADER< | Per uso interno. Nessuna inizializzazione necessaria. |
| SECBUFFER_DATA | Contiene il messaggio di testo non crittografato da crittografare. |
| SECBUFFER_STREAM_TRAILER | Per uso interno. Nessuna inizializzazione necessaria. |
| SECBUFFER_EMPTY | Per uso interno. Nessuna inizializzazione necessaria. Le dimensioni possono essere pari a zero. |
Per ottenere prestazioni ottimali, le strutture pMessage devono essere allocate dalla memoria contigua.
Windows XP: Questa funzione era nota anche come SealMessage. Le applicazioni devono ora usare solo EncryptMessage (Kerberos).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | Sspi.h (include Security.h) |
| Libreria | Secur32.lib |
| DLL | Secur32.dll |