Modifica delle password di SQL Server Native Client a livello di codice

Si applica a:SQL ServerDatabase SQL diAzure Istanzagestita di SQL di Azure Azure Synapse Analytics PlatformSystem (PDW)

Importante

SQL Server Native Client (spesso abbreviato SNAC) è stato rimosso da SQL Server 2022 (16.x) e SQL Server Management Studio 19 (SSMS). SQL Server Native Client (SQLNCLI o SQLNCLI11) e il provider Microsoft OLE DB legacy per SQL Server (SQLOLEDB) non sono consigliati per lo sviluppo di nuove applicazioni. Passare al nuovo Microsoft OLE DB Driver (MSOLEDBSQL) per SQL Server o alla versione più recente di Microsoft ODBC Driver per SQL Server . Per SQLNCLI fornito come componente del motore di database di SQL Server (versioni da 2012 a 2019), vedere questa eccezione relativa al ciclo di vita del supporto.

Nelle versioni precedenti a SQL Server 2005 (9.x) una password di un utente scaduta può essere reimpostata solo da un amministratore. A partire da SQL Server 2005 (9.x), SQL Server Native Client supporta la gestione della scadenza delle password a livello di codice tramite il provider OLE DB di SQL Server Native Client e il driver ODBC di SQL Server Native Client e tramite le modifiche apportate alle finestre di dialogo Account di accesso di SQL Server.

Nota

Quando possibile, richiedere agli utenti di immettere le credenziali in fase di esecuzione ed evitare di archiviarle in un formato persistente. Se è necessario rendere persistenti le credenziali, è consigliabile crittografarle usando l'API di crittografia Win32. Per altre informazioni sull'uso delle password, vedere Password complesse.

Codici di errore degli account di accesso di SQL Server

Quando non è possibile stabilire una connessione a causa di problemi di autenticazione, sarà disponibile uno dei codici di errore di SQL Server seguenti per consentire la diagnosi e il recupero.

Codice di errore di SQL Server	Messaggio di errore
15113	Accesso non riuscito per l'utente '%.*ls' Motivo: impossibile convalidare la password. L'account è bloccato.
18463	Accesso non riuscito per l'utente '%.*ls'. Motivo: impossibile modificare la password. Impossibile utilizzare la password in questo momento.
18464	Accesso non riuscito per l'utente '%.*ls'. Motivo: impossibile modificare la password. La password non soddisfa i criteri di Windows in quanto è troppo breve.
18465	Accesso non riuscito per l'utente '%.*ls'. Motivo: impossibile modificare la password. La password non soddisfa i criteri di Windows in quanto è troppo lunga.
18466	Accesso non riuscito per l'utente '%.*ls'. Motivo: impossibile modificare la password. La password non soddisfa i criteri di Windows in quanto non è sufficientemente complessa.
18467	Accesso non riuscito per l'utente '%.*ls'. Motivo: impossibile modificare la password. La password non soddisfa i requisiti della DLL per il filtro delle password.
18468	Accesso non riuscito per l'utente '%.*ls'. Motivo: impossibile modificare la password. Si è verificato un errore imprevisto durante la convalida della password.
18487	Accesso non riuscito per l'utente '%.*ls'. Motivo: la password dell'account è scaduta.
18488	Accesso non riuscito per l'utente '%.*ls'. Motivo: è necessario modificare la password dell'account.

Provider OLE DB di SQL Server Native Client

Il provider OLE DB di SQL Server Native Client supporta la scadenza delle password anche se un'interfaccia utente e a livello di codice.

Scadenza password dell'interfaccia utente OLE DB

Il provider OLE DB di SQL Server Native Client supporta la scadenza delle password tramite le modifiche apportate alle finestre di dialogo Account di accesso di SQL Server. Se il valore di DBPROP_INIT_PROMPT è impostato su DBPROMPT_NOPROMPT, il tentativo di connessione iniziale non riesce se la password è scaduta.

Se DBPROP_INIT_PROMPT è stato impostato su qualsiasi altro valore, viene visualizzata la finestra di dialogo Account di accesso di SQL Server indipendentemente dalla scadenza della password. L'utente può cambiare la password facendo clic sul pulsante Opzioni e selezionando Cambia password.

Se l'utente fa clic su OK e la password è scaduta, SQL Server richiede all'utente di immettere e confermare una nuova password usando la finestra di dialogo Modifica password SQL Server.

Comportamento del prompt di OLE DB e account bloccati

È possibile che non si riesca a stabilire una connessione perché l'account è bloccato. Se questo problema si verifica in seguito alla visualizzazione della finestra di dialogo Account di accesso di SQL Server, viene visualizzato il messaggio di errore del server e il tentativo di connessione viene interrotto. Il problema può verificarsi anche se, in seguito alla visualizzazione della finestra di dialogo Modifica password SQL Server, l'utente immette un valore non corretto per la vecchia password. In questo caso viene visualizzato lo stesso messaggio di errore e il tentativo di connessione viene interrotto.

Pool di connessioni OLE DB, scadenza password e account bloccati

Un account può essere bloccato o la rispettiva password può scadere mentre la connessione è ancora attiva in un pool di connessioni. Il server controlla le password scadute e gli account bloccati in due circostanze. Quando una connessione viene creata per la prima volta e quando la connessione viene reimpostata, ovvero quando viene estratta dal pool.

Quando il tentativo di ripristino non riesce, la connessione viene rimossa dal pool e viene restituito un errore.

Scadenza password OLE DB a livello di programmazione

Il provider OLE DB di SQL Server Native Client supporta la scadenza delle password tramite l'aggiunta della proprietà SSPROP_AUTH_OLD_PASSWORD (tipo VT_BSTR) aggiunta al set di proprietà DBPROPSET_SQLSERVERDBINIT.

La proprietà "Password" esistente si riferisce a DBPROP_AUTH_PASSWORD e viene utilizzata per archiviare la nuova password.

Nota

Nella stringa di connessione la proprietà "Vecchia password" imposta SSPROP_AUTH_OLD_PASSWORD, ovvero la password corrente (probabilmente scaduta) che non è disponibile tramite una proprietà della stringa del provider.

Il provider non rende persistente il valore di questa proprietà. Quando questa proprietà è impostata, il provider non utilizza il pool di connessioni per la prima connessione, dal momento che verrà stabilita una nuova connessione. Dopo aver cambiato la password, non sarà più possibile utilizzare la connessione corrente in quanto contiene ancora la vecchia password che non è più valida. Se inoltre si riesce ad accedere, il provider cancella questa proprietà. I tentativi successivi di recuperare la vecchia password restituiscono VT_EMPTY.

Nota

SSPROP_AUTH_OLD_PASSWORD non deve essere resa persistente in quanto viene utilizzata solo quando una password è scaduta.

Ogni volta che la proprietà "Vecchia password" viene impostata, il provider presuppone che sia in atto un tentativo di modificare la password, a meno che non venga specificata anche l'autenticazione di Windows. In questo caso, questa avrebbe comunque ha la precedenza.

Se si usa l'autenticazione di Windows, l'immissione della vecchia password restituisce DB_E_ERRORSOCCURRED o DB_S_ERRORSOCCURRED, a seconda se la vecchia password è stata specificata rispettivamente come REQUIRED o OPTIONAL e il valore dello stato di DBPROPSTATUS_CONFLICTINGBADVALUE viene restituito in dwStatus. Questo errore viene rilevato quando viene chiamato IDBInitialize::Initialize.

Se un tentativo di modificare la password non riesce in modo imprevisto, il server restituisce il codice di errore 18468. Dal tentativo di connessione viene restituito un errore OLE DB standard.

Per altre informazioni sul set di proprietà DBPROPSET_SQLSERVERDBINIT, vedere Proprietà di inizializzazione e di autorizzazione.

Driver ODBC di SQL Server Native Client

Il provider OLE DB di SQL Server Native Client supporta la scadenza delle password anche se un'interfaccia utente e a livello di codice.

Scadenza password dell'interfaccia utente ODBC

Il driver ODBC di SQL Server Native Client supporta la scadenza delle password tramite le modifiche apportate alle finestre di dialogo Account di accesso di SQL Server.

Se viene chiamato SQLDriverConnect e il valore di DriverCompletion è impostato su SQL_DRIVER_NOPROMPT, il tentativo di connessione iniziale ha esito negativo se la password è scaduta. Il valore SQLSTATE 28000 e il valore del codice di errore nativo 18487 vengono restituiti dalle chiamate successive a SQLError o SQLGetDiagRec.

Se DriverCompletion è stato impostato su qualsiasi altro valore, l'utente visualizza la finestra di dialogo Di accesso di SQL Server, indipendentemente dal fatto che la password sia scaduta o meno. L'utente può cambiare la password facendo clic sul pulsante Opzioni e selezionando Cambia password.

Se l'utente fa clic su OK e la password è scaduta, SQL Server chiede di immettere e confermare una nuova password usando la finestra di dialogo Modifica password di SQL Server.

Comportamento del prompt di ODBC e account bloccati

È possibile che non si riesca a stabilire una connessione perché l'account è bloccato. Se questo problema si verifica in seguito alla visualizzazione della finestra di dialogo Account di accesso di SQL Server, viene visualizzato il messaggio di errore del server e il tentativo di connessione viene interrotto. Il problema può verificarsi anche se, in seguito alla visualizzazione della finestra di dialogo Modifica password SQL Server, l'utente immette un valore non corretto per la vecchia password. In questo caso viene visualizzato lo stesso messaggio di errore e il tentativo di connessione viene interrotto.

Pool di connessioni ODBC, scadenza password e account bloccati

Un account può essere bloccato o la rispettiva password può scadere mentre la connessione è ancora attiva in un pool di connessioni. Il server controlla le password scadute e gli account bloccati in due circostanze. Quando una connessione viene creata per la prima volta e quando la connessione viene reimpostata, ovvero quando viene estratta dal pool.

Quando il tentativo di ripristino non riesce, la connessione viene rimossa dal pool e viene restituito un errore.

Scadenza password ODBC a livello di programmazione

Il driver ODBC di SQL Server Native Client supporta la scadenza delle password tramite l'aggiunta dell'attributo SQL_COPT_SS_OLDPWD impostato prima della connessione al server tramite la funzione SQLSetConnectAttr .

L'attributo SQL_COPT_SS_OLDPWD dell'handle di connessione si riferisce alla password scaduta. Per questo attributo non è disponibile un attributo di stringa di connessione, in quanto interferirebbe con il pool di connessioni. Se si riesce ad accedere, il driver cancella questo attributo.

Il driver ODBC di SQL Server Native Client restituisce SQL_ERROR in quattro casi per questa funzionalità: scadenza della password, conflitto dei criteri password, blocco dell'account e quando la proprietà password precedente viene impostata durante l'uso dell'autenticazione di Windows. Il driver restituisce i messaggi di errore appropriati all'utente quando viene richiamato SQLGetDiagField .

Vedi anche

Funzionalità di SQL Server Native Client