SqlConnection.ChangePassword 메서드

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.dll

SQL Server 암호를 변경합니다.

오버로드

ChangePassword(String, SqlCredential, SecureString)	SqlCredential 개체에 표시된 사용자의 SQL Server 암호를 변경합니다.
ChangePassword(String, String)	연결 문자열에 표시된 사용자의 SQL Server 암호를 제공된 새 암호로 변경합니다.

ChangePassword(String, SqlCredential, SecureString)

SqlCredential 개체에 표시된 사용자의 SQL Server 암호를 변경합니다.

public:
 static void ChangePassword(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential, System::Security::SecureString ^ newSecurePassword);

public static void ChangePassword (string connectionString, System.Data.SqlClient.SqlCredential credential, System.Security.SecureString newSecurePassword);

static member ChangePassword : string * System.Data.SqlClient.SqlCredential * System.Security.SecureString -> unit

Public Shared Sub ChangePassword (connectionString As String, credential As SqlCredential, newSecurePassword As SecureString)

매개 변수

connectionString

String

서버에 연결할 수 있는 충분한 정보가 포함된 연결 문자열입니다. 연결 문자열은 Integrated Security = true, UserId또는 Password; 연결 문자열 키워드를 사용하지 않아야 합니다. 또는 ContextConnection = true.

credential

SqlCredential

SqlCredential 개체입니다.

newSecurePassword

SecureString

새 암호입니다. newPassword 읽기 전용이어야 합니다. 또한 암호는 서버에 설정된 암호 보안 정책(예: 특정 문자에 대한 최소 길이 및 요구 사항)을 준수해야 합니다.

예외

ArgumentException

연결 문자열에는 UserId, Password또는 Integrated Security=true조합이 포함되어 있습니다.

-또는-

연결 문자열에 Context Connection=true포함됩니다.

-또는-

newSecurePassword(또는 newPassword)가 128자보다 큽니다.

-또는-

newSecurePassword(또는 newPassword)은 읽기 전용이 아닙니다.

-또는-

newSecurePassword(또는 newPassword)은 빈 문자열입니다.

ArgumentNullException

매개 변수(connectionString, credential또는 newSecurePassword) 중 하나가 null입니다.

추가 정보

• ADO.NET 개요

ChangePassword(String, String)

연결 문자열에 표시된 사용자의 SQL Server 암호를 제공된 새 암호로 변경합니다.

public:
 static void ChangePassword(System::String ^ connectionString, System::String ^ newPassword);

public static void ChangePassword (string connectionString, string newPassword);

static member ChangePassword : string * string -> unit

Public Shared Sub ChangePassword (connectionString As String, newPassword As String)

매개 변수

connectionString

String

원하는 서버에 연결할 수 있는 충분한 정보가 포함된 연결 문자열입니다. 연결 문자열에는 사용자 ID와 현재 암호가 포함되어야 합니다.

newPassword

String

설정할 새 암호입니다. 이 암호는 최소 길이, 특정 문자에 대한 요구 사항 등을 포함하여 서버에 설정된 암호 보안 정책을 준수해야 합니다.

예외

ArgumentException

연결 문자열에는 통합 보안을 사용하는 옵션이 포함되어 있습니다.

또는

newPassword 128자를 초과합니다.

ArgumentNullException

connectionString 또는 newPassword 매개 변수가 null입니다.

예제

경고

안전하지 않은 패턴이므로 사용자 이름과 암호를 직접 제공하지 않는 것이 좋습니다. 가능한 경우Azure 리소스에 대한 관리 ID 또는 SQL Server용 Windows 인증 같은 보다 안전한 인증 흐름을 사용합니다.

다음은 암호를 변경하는 간단한 예입니다.

class Program {
   static void Main(string[] args) {
      System.Data.SqlClient.SqlConnection.ChangePassword(
        "Data Source=a_server;Initial Catalog=a_database;UID=user;PWD=old_password",
       "new_password");
   }
}

Module Module1
    Sub Main()
System.Data.SqlClient.SqlConnection.ChangePassword(
        "Data Source=a_server;Initial Catalog=a_database;UID=user;PWD=old_password",
       "new_password")
    End Sub
End Module

다음 콘솔 애플리케이션은 현재 암호가 만료되었기 때문에 사용자의 암호를 변경하는 데 관련된 문제를 보여 줍니다.

using System;
using System.Data;
using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            DemonstrateChangePassword();
        }
        catch (Exception ex)
        {
            Console.WriteLine("Error: " + ex.Message);
        }
        Console.WriteLine("Press ENTER to continue...");
        Console.ReadLine();
    }

    private static void DemonstrateChangePassword()
    {
        // Retrieve the connection string. In a production application,
        // this string should not be contained within the source code.
        string connectionString = GetConnectionString();

        using (SqlConnection cnn = new SqlConnection())
        {
            for (int i = 0; i <= 1; i++)
            {
                // Run this loop at most two times. If the first attempt fails,
                // the code checks the Number property of the SqlException object.
                // If that contains the special values 18487 or 18488, the code
                // attempts to set the user's password to a new value.
                // Assuming this succeeds, the second pass through
                // successfully opens the connection.
                // If not, the exception handler catches the exception.
                try
                {
                    cnn.ConnectionString = connectionString;
                    cnn.Open();
                    // Once this succeeds, just get out of the loop.
                    // No need to try again if the connection is already open.
                    break;
                }
                catch (SqlException ex)
                {
                    if (i == 0 && ((ex.Number == 18487) || (ex.Number == 18488)))
                    {
                        // You must reset the password.
                        connectionString =
                            ModifyConnectionString(connectionString,
                            GetNewPassword());
                    }
                    else
                    {
                        // Bubble all other SqlException occurrences
                        // back up to the caller.
                        throw;
                    }
                }
            }
            SqlCommand cmd = new SqlCommand(
                "SELECT ProductID, Name FROM Product", cnn);
            // Use the connection and command here...
        }
    }

    private static string ModifyConnectionString(
        string connectionString, string NewPassword)
    {

        // Use the SqlConnectionStringBuilder class to modify the
        // password portion of the connection string.
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder(connectionString);
        builder.Password = NewPassword;
        return builder.ConnectionString;
    }

    private static string GetNewPassword()
    {
        // In a real application, you might display a modal
        // dialog box to retrieve the new password. The concepts
        // are the same as for this simple console application, however.
        Console.Write("Your password must be reset. Enter a new password: ");
        return Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // For this demonstration, the connection string must
        // contain both user and password information. In your own
        // application, you might want to retrieve this setting
        // from a config file, or from some other source.

        // In a production application, you would want to
        // display a modal form that could gather user and password
        // information.
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(
            "Data Source=(local);Initial Catalog=AdventureWorks");

        Console.Write("Enter your user id: ");
        builder.UserID = Console.ReadLine();
        Console.Write("Enter your password: ");
        builder.Password = Console.ReadLine();

        return builder.ConnectionString;
    }
}

Option Explicit On
Option Strict On

Imports System.Data
Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            DemonstrateChangePassword()
        Catch ex As Exception
            Console.WriteLine("Error: " & ex.Message)
        End Try
        Console.WriteLine("Press ENTER to continue...")
        Console.ReadLine()
    End Sub

    Private Sub DemonstrateChangePassword()
        Dim connectionString As String = GetConnectionString()
        Using cnn As New SqlConnection()
            For i As Integer = 0 To 1
                ' Run this loop at most two times. If the first attempt fails, 
                ' the code checks the Number property of the SqlException object.
                ' If that contains the special values 18487 or 18488, the code 
                ' attempts to set the user's password to a new value. 
                ' Assuming this succeeds, the second pass through 
                ' successfully opens the connection.
                ' If not, the exception handler catches the exception.
                Try
                    cnn.ConnectionString = connectionString
                    cnn.Open()
                    ' Once this succeeds, just get out of the loop.
                    ' No need to try again if the connection is already open.
                    Exit For

                Catch ex As SqlException _
                 When (i = 0 And (ex.Number = 18487 Or ex.Number = 18488))
                    ' You must reset the password.
                    connectionString = ModifyConnectionString( _
                     connectionString, GetNewPassword())

                Catch ex As SqlException
                    ' Bubble all other SqlException occurrences
                    ' back up to the caller.
                    Throw
                End Try
            Next
            Dim cmd As New SqlCommand("SELECT ProductID, Name FROM Product", cnn)
            ' Use the connection and command here...
        End Using
    End Sub

    Private Function ModifyConnectionString( _
     ByVal connectionString As String, ByVal NewPassword As String) As String

        ' Use the SqlConnectionStringBuilder class to modify the
        ' password portion of the connection string. 
        Dim builder As New SqlConnectionStringBuilder(connectionString)
        builder.Password = NewPassword
        Return builder.ConnectionString
    End Function

    Private Function GetNewPassword() As String
        ' In a real application, you might display a modal
        ' dialog box to retrieve the new password. The concepts
        ' are the same as for this simple console application, however.
        Console.Write("Your password must be reset. Enter a new password: ")
        Return Console.ReadLine()
    End Function

    Private Function GetConnectionString() As String
        ' For this demonstration, the connection string must
        ' contain both user and password information. In your own
        ' application, you might want to retrieve this setting
        ' from a config file, or from some other source.

        ' In a production application, you would want to 
        ' display a modal form that could gather user and password
        ' information.
        Dim builder As New SqlConnectionStringBuilder( _
         "Data Source=(local);Initial Catalog=AdventureWorks")

        Console.Write("Enter your user id: ")
        builder.UserID = Console.ReadLine()
        Console.Write("Enter your password: ")
        builder.Password = Console.ReadLine()

        Return builder.ConnectionString
    End Function
End Module

설명

Windows Server에서 SQL Server를 사용하는 경우 클라이언트 애플리케이션에서 기존 암호를 변경하기 위해 현재 암호와 새 암호를 모두 제공할 수 있는 기능을 활용할 수 있습니다. 애플리케이션은 이전 암호가 만료된 경우 초기 로그인 중에 사용자에게 새 암호를 요청하는 등의 기능을 구현할 수 있으며 관리자의 개입 없이 이 작업을 완료할 수 있습니다.

경고

안전하지 않은 패턴이므로 사용자 이름과 암호를 직접 제공하지 않는 것이 좋습니다. 가능한 경우Azure 리소스에 대한 관리 ID 또는 SQL Server용 Windows 인증 같은 보다 안전한 인증 흐름을 사용합니다.

ChangePassword 메서드는 제공된 connectionString 매개 변수에 표시된 사용자의 SQL Server 암호를 newPassword 매개 변수에 제공된 값으로 변경합니다. 연결 문자열에 통합 보안(즉, "통합 보안=True" 또는 이와 동등한) 옵션이 포함되어 있으면 예외가 throw됩니다.

암호가 만료되었는지 확인하려면 Open 메서드를 호출하면 SqlException발생합니다. 연결 문자열 내에 포함된 암호를 다시 설정해야 함을 나타내기 위해 예외의 Number 속성에는 상태 값 18487 또는 18488이 포함됩니다. 첫 번째 값(18487)은 암호가 만료되었음을 나타내고 두 번째 값(18488)은 로그인하기 전에 암호를 재설정해야 임을 나타냅니다.

이 메서드는 서버에 대한 자체 연결을 열고, 암호 변경을 요청하고, 완료되는 즉시 연결을 닫습니다. 이 연결은 SQL Server 연결 풀에서 검색되거나 반환되지 않습니다.

추가 정보

• 연결 문자열(ADO.NET)
• 데이터 원본에 연결(ADO.NET)
• .NET Framework Data Provider for SQL Server 사용
• ADO.NET 개요