Two factor authentication ko KR

2단계 인증

Steam에는 계정 관련 여러 활동에 추가 정보를 요구하는 2단계 인증 시스템(2FA)이 있습니다. 자세한 내용은 여기 와 여기 에 있습니다. 이 페이지에서는 그 2FA 시스템과, 여기에 연동되는 ASF의 솔루션인 ASF 2FA를 다룹니다.

---

ASF 논리 구조

ASF 2FA를 사용하는지 여부와 관계없이, ASF에는 적절한 로직이 포함되어 있으며 Steam에서 2FA로 보호된 계정을 완전히 인식합니다. 예를 들어 로그인 중에도 필요하면 세부사항을 입력하도록 요청할 것입니다. 해당 정보를 수동으로 제공할 수도 있지만, 일부 ASF 기능(예: MatchActively)은 봇 계정에서 ASF 2FA가 작동 중이어야 합니다. 그래야 ASF가 필요로 할 때마다 2FA 요청에 자동으로 응답할 수 있습니다.

---

ASF 2단계 인증(2FA)

ASF 2FA는 토큰 생성 및 확인 수락과 같은 2FA 기능을 ASF 프로세스에 제공하는 역할을 하는 내장 모듈입니다. 독립형 모드로 작동할 수도 있고, 기존 인증기 정보를 복제해 작동할 수도 있습니다(따라서 현재 사용 중인 인증기와 ASF 2FA를 동시에 사용할 수 있습니다).

2fa 명령어 를 실행하여 봇 계정이 이미 ASF 2단계 인증을 사용중인지 확인할 수 있습니다. ASF 2FA를 설정하지 않으면 모든 표준 2fa 명령이 작동하지 않으며, 이는 해당 모듈의 작동을 필요로 하는 ASF 고급 기능을 봇이 사용할 수 없다는 뜻입니다.

---

권장 사항

ASF 2FA를 작동시키는 방법은 매우 다양하며, 여기서는 현재 상황에 따른 권장 사항을 안내합니다:

• 2FA 정보를 손쉽게 추출할 수 있는 비공식 서드파티 앱을 이미 사용 중이라면, 그 정보를 ASF로 **가져오기**만 하면 됩니다.
• 공식 앱을 사용 중이고 2FA 자격 증명을 재설정해도 상관없다면, 가장 좋은 방법은 2FA를 비활성화한 다음 **결합형 인증기**를 사용해 새 2FA 자격 증명을 **생성**하는 것입니다. 이렇게 하면 공식 앱과 ASF 2FA를 함께 사용할 수 있습니다. 이 방법은 루트 권한이 필요 없고, 탈옥이나 고급 지식도 필요 없이 여기에 적힌 안내만 따르면 되므로, 이 상황에서는 확실히 더 나은 선택입니다.
• 공식 앱을 사용 중이면서 2FA 자격 증명을 다시 만들고 싶지 않다면 선택지가 매우 제한적입니다. 일반적으로 루트 권한과 그 정보를 가져오기 위한 추가적인 작업이 필요하며, 그렇게 해도 불가능할 수 있습니다.
• 아직 2FA를 사용하지 않고 있고 상관없다면, **독립형 인증기**나 공식 앱과 함께 쓰는 결합형 인증기 방식으로 ASF 2FA를 사용하는 것을 권장합니다(위와 동일).

아래에서는 가능한 모든 선택지와 저희가 알고 있는 방법들을 다룹니다.

---

생성

ASF는 공식 MobileAuthenticator **플러그인**을 함께 제공하며, 이는 ASF 2FA를 확장하여 완전히 새로운 2FA authenticator를 연동할 수 있게 해줍니다. 이 방법은 다른 도구를 사용할 수 없거나 사용하고 싶지 않고, ASF 2FA가 주 인증기(그리고 아마도 유일한 인증기)가 되어도 괜찮은 경우에 유용합니다. 생성 과정은 결합형 인증기 방식에서도 사용됩니다. 이 경우 당연히 인증기가 두 곳에 동시에 존재할 수 있으며, 양쪽 모두 동일한 코드를 생성하고 동일한 확인 요청을 승인할 수 있습니다.

두 시나리오의 공통 단계

ASF를 독립형 인증기로 사용하든 결합형 인증기로 사용하든, 다음 초기화 단계를 수행해야 합니다:

1. 대상 계정에 대한 ASF 봇을 생성하고 실행한 뒤 로그인합니다. 아마 이미 하셨을 것입니다.
2. 봇이 사용할 수 있도록 **여기**에서 계정에 정상적으로 작동하는 전화번호를 등록합니다. 이렇게 하면 SMS 코드를 받을 수 있고, 필요한 경우 복구도 가능합니다. 이 단계가 모든 상황에서 필수는 아니지만, 무엇을 하고 있는지 확실히 아는 경우가 아니라면 권장합니다.
3. 계정에 2FA를 아직 사용하고 있지 않은지 확인하고, 사용 중이라면 먼저 비활성화하세요. 이 작업은 계정을 일시적인 거래 보류 상태로 만듭니다. 이를 피할 방법은 없으며, 가져오기 과정만 이를 건너뛸 수 있습니다.
4. 2fainit [Bot] 명령을 실행하고, [Bot]을 봇 이름으로 바꿉니다.

정상적인 응답을 받았다면, 다음 두 가지가 일어난 것입니다:

• ASF가 config 디렉터리에 새 <Bot>.maFile.PENDING 파일을 생성했습니다.
• Steam에서 위에 등록한 전화번호로 SMS가 발송되었습니다. 전화번호를 설정하지 않았다면 대신 계정 이메일 주소로 메일이 발송되었습니다.

인증기 정보는 아직 작동하지 않지만, 원한다면 생성된 파일을 확인해 볼 수 있습니다. 더 확실히 하고 싶다면, 예를 들어 폐기 코드를 미리 적어 둘 수 있습니다. 다음 단계는 선택한 시나리오에 따라 달라집니다.

독립형 인증기

ASF를 주 인증기(또는 유일한 인증기)로 사용하고 싶다면, 이제 마지막 마무리 단계를 수행해야 합니다:

5. 2fafinalize [Bot] <ActivationCode> 명령을 실행하되, [Bot]은 봇 이름으로, <ActivationCode>은 이전 단계에서 SMS나 이메일로 받은 코드로 바꿉니다.

결합형 인증기

ASF와 공식 Steam 모바일 앱 양쪽에서 동일한 인증기를 사용하고 싶다면, 이제 다음의 조금 더 까다로운 단계를 수행해야 합니다:

5. 이전 단계에서 받은 SMS 또는 이메일 코드는 무시합니다.
6. Steam 모바일 앱이 설치되어 있지 않다면 설치한 뒤 실행합니다. Steam Guard 탭으로 이동해 앱의 안내에 따라 새 인증기를 추가합니다.
7. 모바일 앱의 인증기가 추가되어 정상 작동하면 ASF로 돌아옵니다. 이제 마무리 대신, 앞서 생성한 정보를 모바일 앱이 이미 활성화했다는 사실을 ASF에 알려 주기만 하면 됩니다:

• Steam 모바일 앱에 다음 2FA 코드가 표시될 때까지 기다린 뒤, 2fafinalize [Bot] <2FACodeFromApp> 명령을 사용하되 [Bot]은 봇 이름으로, <2FACodeFromApp>은 현재 Steam 모바일 앱에 보이는 코드로 바꿉니다. 이는 Steam에 로그인할 때 사용할 코드와 동일한 것이며, 활성화에 이미 사용한 코드가 아닙니다. ASF가 생성한 코드와 입력한 코드가 일치하면, ASF는 인증기가 올바르게 추가되었다고 판단하고 새로 생성된 인증기 가져오기를 진행합니다.
• 자격 증명이 유효한지 확인하기 위해 위 과정을 수행할 것을 강력히 권장합니다. 다만 코드가 일치하는지 확인하고 싶지 않거나(또는 확인할 수 없고) 무엇을 하고 있는지 잘 알고 있다면, 대신 2fafinalizedforce [Bot] 명령을 사용하고 [Bot]을 봇 이름으로 바꿀 수 있습니다. ASF는 인증기가 올바르게 추가되었다고 판단하고 새로 생성된 인증기 가져오기를 진행합니다. 이 모드에서는 ASF가 코드 일치 여부를 확인할 수 없으므로, 유효하지 않은(활성화되지 않은) 자격 증명을 가져올 가능성이 있다는 점에 유의하세요.

마무리 후

모든 것이 정상적으로 진행되었다면, 앞서 생성된 <Bot>.maFile.PENDING 파일의 이름이 <Bot>.maFile.NEW으로 변경됩니다. 이는 2FA 자격 증명이 이제 유효하며 활성화되었음을 의미합니다. 해당 파일을 config 디렉터리 밖으로 옮기고 안전한 위치에 보관할 것을 권장합니다. 여기에 더해, 독립형 인증기를 사용하기로 했다면 원하는 편집기로 파일을 열어 revocation_code를 적어 둘 것을 권장합니다. 이름에서 알 수 있듯이, 인증기를 분실했을 때 이 코드로 인증기를 폐기할 수 있습니다. 결합형 인증기 방식에서는 이미 Steam 모바일 앱에서 해당 작업을 하셨겠지만, 필요하다면 여기서도 동일하게 하셔도 됩니다.

기술적인 세부 사항에 관해 말씀드리면, 생성된 maFile에는 인증기를 연결하는 과정에서 Steam 서버로부터 받은 모든 정보가 포함되며, 여기에 더해 device_id 필드도 포함됩니다. 이 필드는 나중에 해당 maFile을 다른 (서드파티) 인증기로 가져오기로 결정한 경우 필요할 수 있습니다.

절차가 완료되면 ASF가 인증기를 자동으로 가져오며, 따라서 2fa 및 관련 명령들이 인증기를 연결한 봇 계정에서 이제 작동해야 합니다. 이를 확인해 보실 것을 권장합니다.

---

불러오기

가져오기 과정에는 이미 연결되어 정상 작동 중이며 ASF가 지원하는 인증기가 필요합니다. 필요한 자격 증명을 직접 입력하는 수동 방식 외에도, 몇 가지 공식·비공식 2FA 소스에 대한 안내를 제공하고 있습니다. 이 안내는 해당 솔루션을 이미 사용 중인 경우에만 참고해야 한다는 점에 유의하세요. 여기서 다루는 과정은 서드파티 앱과 도구를 사용하므로 저희는 그 사용을 권장하지 않으며, 이미 사용하기로 결정했고 생성된 정보를 ASF 2FA로 가져오려는 분들만을 위해 언급하는 것입니다.

일반적으로 가져오기 과정은 적절한 형식의 maFile을 ASF의 config 디렉터리에 넣는 것으로 이루어지며, 그러면 ASF가 해당 파일을 인식한 뒤 보안상의 이유로 자동으로 삭제합니다.

아래의 모든 가이드는 정상동작하고 있는 인증기를 필요로 합니다. 유효하지 않은 데이터를 가져오면 ASF 2단계 인증은 정상적으로 동작하지 않을것이므로 데이터를 가져오기 전에 인증기가 정상 작동하는지 확인하여야 합니다. 다음의 인증기 기능이 정상 작동하는지 테스트하고 확인하십시오.

• 토큰을 생성할 수 있고, 그 토큰이 Steam 네트워크에서 정상적으로 받아들여집니다(해당 토큰으로 로그인할 수 있습니다)
• 확인사항을 가져오고, 모바일 인증기에 도착할수 있어야 함
• 확인 요청에 응답할 수 있고, Steam 네트워크에서 승인/거부로 정상 인식됩니다

위 동작들이 정상적으로 되는지 확인해 인증기가 작동하는지 점검하세요. 이것들이 작동하지 않으면 ASF에서도 작동하지 않습니다.

안드로이드 전화기

일반적으로 Android 휴대폰에서 authenticator를 가져오려면 root 권한이 필요합니다. 아래 안내는 Android 모딩 분야에 대한 상당한 수준의 지식을 필요로 합니다. 여기서 모든 단계를 설명하지는 않을 것이므로, 아래 내용에 대한 추가 정보나 도움이 필요하면 XDA 및 기타 자료를 참고하세요.

현재로서는 계속 작동하는 것으로 알려지고 확인된 추출 방법이 없습니다. 그래도 예를 들어 구버전 앱으로 아래 단계를 시도해 볼 수는 있지만, 정상적으로 작동한다고 보장하지는 않습니다. 대신 결합형 인증기 방식을 사용하는 것을 고려해 보세요.

보존용 안내

공식 **Steam 앱**이 설치되어 정상 작동한다고 가정합니다(아래 과정에는 기기 루팅이 필요합니다):

• **Magisk**를 설치하고 설정에서 Zygisk를 활성화합니다.
• **LSPosed**를 설치하고(Zygisk용) 정상 작동하는지 확인합니다.
• SteamGuardDump 또는 SteamGuardExtractor LSPosed 모듈을 설치하고 LSPosed 설정에서 활성화합니다.
• Steam 앱을 강제 종료한 뒤 다시 실행하면, 이제 Steam Guard 정보를 클립보드로 복사할 수 있어야 합니다.

필요한 정보를 성공적으로 추출했으니, 매번 자동으로 복사되지 않도록 모듈을 비활성화한 뒤, ASF 2FA에 추가하려는 계정의 shared_secret과 identity_secret 값을 복사해 아래 구조로 새 텍스트 파일에 넣습니다:

{
  "shared_secret": "STRING",
  "identity_secret": "STRING"
}

각 STRING 값을 추출한 정보에서 얻은 해당 개인 키로 바꿉니다. 그런 다음 파일 이름을 BotName.maFile로 변경합니다. 여기서 BotName은 ASF 2FA를 추가하려는 봇의 이름입니다. 그리고 아직 넣지 않았다면 ASF의 config 디렉터리에 넣습니다.

ASF를 실행하면 파일을 인식하고 가져옵니다. 유효한 시크릿이 담긴 올바른 파일을 가져왔다면 모든 것이 정상적으로 작동해야 하며, 2fa 명령으로 이를 확인할 수 있습니다. 실수를 했다면, 언제든 필요한만큼 Bot.db를 삭제하고 다시 시작할 수 있습니다.

SteamDesktopAuthenticator

이미 SDA에서 실행되는 인증기가 있다면 maFiles 폴더에 steamID.maFile 파일이 있음을 알것입니다. ASF는 SDA 파일을 복호화할 수 없으므로 maFile이 암호화되지 않은 상태인지 확인하세요. 암호화되지 않은 파일의 내용은 { 문자로 시작해 } 문자로 끝나야 합니다. 필요하다면 SDA 설정에서 암호화를 먼저 해제하고, 작업이 끝난 뒤 다시 활성화하면 됩니다. 파일이 암호화되지 않은 상태가 되면 ASF의 config 디렉터리로 복사합니다.

이제 ASF config 디렉터리에서 steamID.maFile의 이름을 BotName.maFile로 변경할 수 있습니다. 여기서 BotName은 ASF 2FA를 추가하려는 봇의 이름입니다. 또는 그대로 둘 수도 있습니다. ASF는 로그인 후 자동으로 선택할 것입니다. 파일 이름을 변경하면 로그인 전에도 ASF 2FA를 사용할 수 있게 되어 ASF에 도움이 됩니다. 그렇게 하지 않으면 ASF가 로그인에 성공한 후에야 파일을 인식할 수 있습니다(ASF는 실제로 로그인하기 전까지 계정의 steamID를 알지 못하기 때문입니다).

ASF를 실행하면 파일을 인식하고 가져옵니다. 유효한 시크릿이 담긴 올바른 파일을 가져왔다면 모든 것이 정상적으로 작동해야 하며, 2fa 명령으로 이를 확인할 수 있습니다. 실수를 했다면, 언제든 필요한만큼 Bot.db를 삭제하고 다시 시작할 수 있습니다.

WinAuth

먼저 새로운 빈 봇이름.maFile 파일을 ASF 환경설정 디렉토리에 생성하십시오. 봇이름은 ASF 2단계 인증을 추가하려는 봇의 이름입니다. 부정확한 이름을 넣으면 ASF가 선택하지 않습니다.

이제 평소처럼 WinAuth를 실행하십시오. Steam 아이콘을 오른쪽 클릭하고 "Show SteamGuard and Recovery Code"를 선택하십시오. 그리고 "Allow copy"에 체크합니다. {로 시작하는 친숙한 JSON 구조가 창의 아래쪽에 나타납니다. 이전 단계에서 생성한 봇이름.maFile 파일에 전체 텍스트를 복사해 넣습니다.

ASF를 실행하면 파일을 인식하고 가져옵니다. 유효한 시크릿이 담긴 올바른 파일을 가져왔다면 모든 것이 정상적으로 작동해야 하며, 2fa 명령으로 이를 확인할 수 있습니다. 실수를 했다면, 언제든 필요한만큼 Bot.db를 삭제하고 다시 시작할 수 있습니다.

수동

고급사용자의 경우, 직접 maFile을 수동으로 생성할 수 있습니다. 이 방법은 위에서 설명한 것 외의 다른 소스에서 인증기를 가져오려는 경우에 사용할 수 있습니다. 파일은 **유효한 JSON 구조**를 가져야 합니다:

{
  "shared_secret": "STRING",
  "identity_secret": "STRING"
}

표준 인증기 데이터는 더 많은 항목이 있지만, ASF의 가져오기 단계에서 모두 무시되므로 필요하지 않습니다. 해당 항목들을 제거할 필요는 없습니다. ASF는 위에서 설명한 두 개의 필수 필드가 포함된 유효한 JSON만 요구하며, 추가 필드가 있더라도 무시합니다. 물론 위 예시의 STRING 자리 표시자는 계정에 맞는 유효한 값으로 바꿔야 합니다. 각 STRING은 해당 개인 키를 구성하는 바이트를 base64로 인코딩한 값이어야 합니다.

---

자주 묻는 질문(FAQ)

ASF가 2단계 인증 모듈을 어떻게 사용합니까?

ASF 2단계 인증을 사용할 수 있으면 ASF는 ASF가 보내거나 받는 거래의 자동 수락에 2단계 인증을 사용합니다. 예를 들어 로그인 같이 필요에 따라 2단계 인증 토큰을 자동으로 생성할 수도 있습니다. 또한, ASF 2단계 인증은 2fa 명령어를 사용가능하게 합니다.

2FA 토큰은 어떻게 얻나요?

2단계 인증으로 보호된 계정에 접근하려면 2단계 인증 토큰이 필요합니다. 이는 ASF 2단계 인증이 있는 모든 계정을 포함합니다. 독립형 인증기를 사용하기로 했다면, 2fa <BotNames> 명령으로 해당 봇 인스턴스의 임시 토큰을 생성해야 합니다. 그 외의 모든 경우에는 기존에 사용하던 인증기를 사용할 것을 권장하지만, 더 편하다면 이 명령을 사용하셔도 됩니다.

ASF 2단계 인증으로 가져온 후에도 원래 인증기를 사용할 수 있습니까?

네. 원래 인증기도 정상작동하며 ASF 2단계 인증과 함께 사용할 수 있습니다. 다만 어떤 방법으로든 인증기를 무효화하면 연결된 ASF 2FA 자격 증명도 더 이상 유효하지 않게 된다는 점에 유의하세요.

ASF 2단계 인증을 제거하려면 어떻게 해야 합니까?

그냥 ASF를 중지하고 제거하려는 ASF 2단계 인증과 연결된 봇의 봇이름.db 파일을 삭제하십시오. 이 옵션은 ASF에 연결된, 가져온 2FA를 제거하지만 인증기를 무효화(연결 해제)하지는 않습니다. 인증기 자체를 무효화하고 싶다면, (먼저) ASF에서 제거한 뒤 사용 중인 원래 인증기에서 연결을 해제해야 합니다. 어떤 이유로든, 예를 들어 ASF 2FA를 독립형 모드로 사용하고 있어 그렇게 할 수 없다면, 설정 과정에서 받은 폐기 코드를 Steam 웹사이트에서 사용하세요. ASF를 통해 인증기를 무효화할 수는 없습니다.

서드파티 앱에서 인증기를 연결한 뒤 ASF로 가져왔습니다. 이제 제 휴대전화에서 다시 연결할 수 있나요?

아니요. 그렇게 하면 앞서 가져온 자격 증명이 무효화되어 ASF 2FA가 작동을 멈춥니다(생성되는 코드가 더 이상 Steam에서 받아들여지지 않게 됩니다). 먼저 원래 인증기나 서드파티 인증기를 어디에 둘지 결정한 다음, 그것을 ASF 2FA로 가져오세요.

결합형 인증기를 사용 중인데, 앱을 다른 휴대전화로 옮길 수 있나요?

아니오. Steam에서 인증기를 "이동" 또는 "이전"한다고 표현하는 것은, 실제로는 기존 인증기를 무효화하고 새 인증기를 할당하는 작업을 한 번에 처리하는 것과 같습니다. 이렇게 하면 두 단계를 따로 진행할 때 발생하는 과도한 대기 시간 등을 건너뛸 수 있지만, ASF 입장에서는 앞서 ASF에서 생성한 자격 증명이 무효화되어 ASF 2FA 모듈 전체가 작동하지 않게 됩니다.

권장하는 방법은 기존 휴대전화에서 인증기를 완전히 제거한 뒤, 새 휴대전화에서 결합형 인증기 방식을 다시 사용하는 것입니다. 이미 인증기를 이동했다면 기존 ASF 2FA 자격 증명은 이미 무효화된 상태이므로, 이제 남은 일은 "이동한" 인증기를 제거하고 결합형 인증기 방식으로 새 인증기를 다시 연결하는 것뿐입니다.

모든 확인 요청을 승인하도록 설정한 서드파티 인증기보다 ASF 2FA를 사용하는 것이 더 나은가요?

여러가지 측면에서 그렇습니다. 첫째, 그리고 가장 중요한 것은 ASF 2단계 인증은 보안을 상당히 증가시킵니다. ASF 2단계 인증 모듈은 ASF 자체의 확인사항만을 수락하므로, 공격자가 해로운 거래를 요청한다고 해도 ASF 2단계 인증은 ASF가 생성한 것이 아니기 때문에 그러한 거래를 수락하지 않습니다. 보안 측면에 더해, ASF 2FA를 사용하면 성능/최적화 면에서도 이점이 있습니다. ASF 2FA는 확인 요청이 생성된 직후에만 이를 가져와 승인하기 때문이며, 이는 다른 솔루션들이 X분마다 확인 요청을 폴링하는 비효율적인 방식과 대비됩니다. ASF가 생성하는 확인 요청을 자동화할 계획이라면 ASF 2FA 대신 서드파티 인증기를 사용할 이유가 없습니다. 바로 그것이 ASF 2FA의 목적이며, ASF 2FA를 사용한다고 해서 원하는 인증기로 나머지 모든 것을 승인하는 데 지장이 생기지도 않습니다. ASF 활동 전반에 ASF 2FA를 사용하실 것을 강력히 권장합니다.