> For the complete documentation index, see [llms.txt](https://docs.officepassword.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.officepassword.kr/using-officepassword/create-a-password/how-to-use-the-authentication-code.md).

# 인증 코드 이용 방법

오피스패스워드는 2FA를 설정한 웹사이트/서버의 사용자 로그인을 안전하게 돕기 위해 TOTP 방식의 시간단위로 계속 변경되는 인증 코드를 생성하여 지원합니다. 패스워드 템플릿에 '**인증 코드(Authenticator)**'라는 템플릿이 기본으로 제공되어, 2FA를 설정한 사이트의 사용자 로그인을 서버에서 생성한 인증 키를 암호화하여 생성된 인증 코드를 계속 생성하여 제공합니다. 기본 30초 내에 인증 키 영역에 표시되는 인증 코드를 입력하여 사이트 로그인을 할 수 있습니다. 

## 인증 코드(TOTP) 사용하기 <a href="#using-the-authentication-code-totp" id="using-the-authentication-code-totp"></a>

OfficePassword의 **인증 코드** 기능을 사용하면 GitHub, Google, AWS, Microsoft와 같은 외부 서비스의 2단계 인증 코드를 OfficePassword에서 생성하고 관리할 수 있습니다.

서비스에서 제공하는 인증 키 또는 QR 코드를 OfficePassword에 한 번 등록하면, 로그인할 때 필요한 **6자리 일회용 인증 코드**가 자동으로 생성됩니다. 별도의 인증 앱을 열지 않고도 계정 정보와 인증 코드를 한곳에서 안전하게 관리할 수 있습니다.

> **중요**
>
> 이 기능은 OfficePassword에 로그인할 때 사용하는 2단계 인증 기능이 아닙니다.\
> GitHub, Google, AWS 등 **다른 서비스에 로그인할 때 필요한 인증 코드를 생성하는 기능**입니다.

***

### 인증 코드가 필요한 이유 <a href="#why-an-authentication-code-is-needed" id="why-an-authentication-code-is-needed"></a>

일반적인 웹사이트 로그인에서는 아이디와 비밀번호를 입력합니다. 하지만 비밀번호가 유출되면 다른 사람이 해당 계정에 로그인할 수 있습니다.

2단계 인증을 설정하면 비밀번호를 입력한 다음, 일정 시간마다 변경되는 인증 코드를 한 번 더 입력해야 합니다.

로그인 과정은 다음과 같습니다.

1. 사이트에 아이디와 비밀번호를 입력합니다.
2. 사이트에서 2단계 인증 코드를 요청합니다.
3. OfficePassword에서 해당 사이트의 6자리 인증 코드를 확인합니다.
4. 사이트의 인증 코드 입력란에 코드를 입력합니다.
5. 코드가 일치하면 로그인이 완료됩니다.

따라서 다른 사람이 비밀번호를 알고 있더라도 현재 유효한 인증 코드를 알지 못하면 계정에 로그인하기 어렵습니다.

> #### 사용 예: GitHub 로그인 <a href="#usage-example-github-login" id="usage-example-github-login"></a>
>
> 예를 들어, GitHub 계정에서 2단계 인증을 활성화했다고 가정해 보겠습니다.&#x20;
>
> GitHub에 아이디와 비밀번호를 입력하면 GitHub에서 인증 앱의 코드를 입력하라는 화면이 나타납니다. 이때 OfficePassword에 저장된 GitHub 레코드를 열고 현재 표시되는 6자리 코드를 GitHub에 입력하면 됩니다.

***

### TOTP란 무엇인가요? <a href="#what-is-totp" id="what-is-totp"></a>

TOTP는 **Time-based One-Time Password**의 약자로, 시간을 기준으로 생성되는 일회용 비밀번호입니다.

OfficePassword는 사이트에서 발급한 인증 키와 현재 시간을 조합하여 일반적으로 6자리 숫자를 생성합니다. 코드는 기본적으로 약 30초 동안만 유효하며, 시간이 지나면 자동으로 새로운 코드로 변경됩니다.

<table data-search="false"><thead><tr><th width="230.446044921875">용어</th><th>의미</th></tr></thead><tbody><tr><td>2단계 인증 또는 2FA</td><td>비밀번호 외에 추가 인증 수단을 한 번 더 확인하는 보안 방식</td></tr><tr><td>OTP</td><td>한 번만 또는 짧은 시간 동안 사용할 수 있는 일회용 비밀번호</td></tr><tr><td>TOTP</td><td>현재 시간을 기준으로 생성되는 OTP 방식</td></tr><tr><td>인증 코드</td><td>로그인할 때 사이트에 입력하는 6자리 숫자</td></tr><tr><td>인증 키</td><td>인증 코드를 만드는 데 사용되는 원본 비밀값</td></tr><tr><td>QR 코드</td><td>인증 키와 서비스 정보를 그림 형태로 표현한 등록 정보</td></tr><tr><td><code>otpauth://</code> 주소</td><td>인증 키와 설정 정보를 포함하는 표준 주소 형식</td></tr></tbody></table>

> <mark style="color:red;">**인증 키와 인증 코드는 서로 다릅니다**</mark>
>
> * **인증 키**는 처음 등록할 때 사용하는 원본 정보이며 계속 동일합니다.
> * **인증 코드**는 인증 키로부터 생성되며 약 30초마다 변경됩니다.
>
> 인증 키가 노출되면 다른 사람도 동일한 인증 코드를 계속 생성할 수 있으므로 비밀번호처럼 보호해야 합니다.

***

## 인증 코드 등록 준비하기 <a href="#preparing-to-register-the-authentication-code" id="preparing-to-register-the-authentication-code"></a>

인증 코드는 OfficePassword에서 임의로 만드는 것이 아닙니다. 먼저 사용하려는 사이트에서 2단계 인증을 활성화하고, 해당 사이트가 제공하는 인증 키 또는 QR 코드를 OfficePassword에 등록해야 합니다.

사이트에 따라 다음과 같은 메뉴에서 설정할 수 있습니다.

* 보안
* 로그인 및 보안
* 2단계 인증
* Two-factor authentication
* Two-step verification
* Authenticator app
* OTP 또는 TOTP

사이트의 2단계 인증 설정 화면에는 일반적으로 다음 정보가 표시됩니다.

* 인증 앱으로 스캔할 수 있는 QR 코드
* QR 코드를 사용할 수 없을 때 입력하는 인증 키 또는 설정 키
* 인증 앱에 등록된 코드를 확인하는 6자리 코드 입력란
* 계정 복구에 사용할 수 있는 복구 코드

> **사전에 확인하세요**
>
> OfficePassword의 인증 코드 기능은 TOTP 방식을 지원합니다. 횟수를 기준으로 생성하는 HOTP, Steam 인증 코드 등 일부 방식은 지원하지 않습니다.

***

## 인증 코드 등록하기 <a href="#register-authentication-code" id="register-authentication-code"></a>

### 1. 원하는 사이트에서 2단계 인증 설정 시작하기 <a href="#id-1.-start-setting-up-2-step-verification-on-your-desired-site" id="id-1.-start-setting-up-2-step-verification-on-your-desired-site"></a>

GitHub와 같이 인증 코드를 사용할 사이트에 로그인한 다음, 계정 보안 설정에서 2단계 인증을 활성화합니다.

인증 방법을 선택하는 화면이 나타나면 **인증 앱**, **Authenticator app** 또는 이와 유사한 항목을 선택합니다.

사이트 화면에 QR 코드나 인증 키가 표시되면 해당 화면을 닫지 않은 상태로 OfficePassword를 엽니다.

<details>

<summary>예: GitHub의 2FA 설정 방법</summary>

1. GitHub 웹사이트에 로그인합니다.
2. 우측 상단 프로필 사진을 누르고 **Settings** 메뉴를 엽니다.
3. 왼쪽 메뉴에서 **Password and authentication**을 선택합니다.
4. **Enable two-factor authentication** 버튼을 누릅니다.
5. **Set up using an app** 항목을 선택합니다.
6. 휴대폰에 설치한 인증 앱(구글 OTP, 구글 Authenticator 등)으로 화면에 나오는 **QR 코드**를 스캔합니다.
7. 앱에 표시되는 **6자리 숫자**를 GitHub 입력창에 적어 확인합니다.
8. 나중에 로그인이 안 될 때 쓰는 **복구 코드(Recovery codes)**&#xB97C; 다운로드하거나 안전한 곳에 적어둡니다.

</details>

> **주의**
>
> 사이트에서 제공하는 QR 코드와 인증 키는 등록 과정이 완료될 때까지 필요합니다. OfficePassword에 저장하고 사이트에서 확인 코드까지 정상적으로 승인받기 전에 설정 화면을 닫지 마세요.

***

### 2. 오피스패스워드에서 인증 코드 템플릿 선택하기 <a href="#id-2.-select-authentication-code-template-from-office-password" id="id-2.-select-authentication-code-template-from-office-password"></a>

* 브라우저에서 OfficePassword 화면 왼쪽 위의 **생성**을 클릭하고, '패스워드'를 선택합니다.
* 생성 창의 템플릿 목록에서 **인증 코드**를 선택합니다.

<figure><img src="https://3126530569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwcfZI3tFDjk54Cp5Ypy%2Fuploads%2FjJO1LGXKcopzzsYhpWDk%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-08-12%20%E1%84%8B%E1%85%A9%E1%84%8C%E1%85%A5%E1%86%AB%2012.40.41.png?alt=media&amp;token=cfeca67b-fe25-4e00-8741-25a99b59c707" alt="" width="231"><figcaption><p><strong>생성 메뉴에서 인증 코드 템플릿을 선택한 화면</strong></p></figcaption></figure>

***

### 3. 기본 정보 입력하기 <a href="#id-3.-enter-basic-information" id="id-3.-enter-basic-information"></a>

다음 정보를 입력합니다.

<table><thead><tr><th width="152.62835693359375">항목</th><th>입력 내용</th></tr></thead><tbody><tr><td>제목</td><td>서비스를 구분할 수 있는 이름을 입력합니다. 예: GitHub, 회사 AWS</td></tr><tr><td>아이디</td><td>해당 사이트에서 사용하는 로그인 아이디나 이메일 주소를 입력합니다.</td></tr><tr><td>웹사이트</td><td>해당 서비스의 로그인 주소를 입력합니다.</td></tr><tr><td>인증 키</td><td>사이트에서 제공한 인증 키, <code>otpauth://</code> 주소 또는 QR 코드를 등록합니다.</td></tr></tbody></table>

제목과 인증 키는 필수 항목입니다. 아이디와 웹사이트를 함께 입력해 두면 여러 계정의 인증 코드를 관리할 때 어떤 계정의 코드인지 쉽게 구분할 수 있습니다.

<figure><img src="https://3126530569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwcfZI3tFDjk54Cp5Ypy%2Fuploads%2F0BdFulHMHFWlM2cO0waR%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-08-11%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%2010.38.44.png?alt=media&amp;token=de098332-3aad-48b3-8719-fba8326e3004" alt="" width="375"><figcaption><p><strong>제목, 아이디, 웹사이트 및 인증 키를 입력한 화면</strong></p></figcaption></figure>

> **활용 팁**
>
> 동일한 서비스에 계정이 여러 개 있다면 제목에 용도를 함께 적어 두세요.
>
> * GitHub - 개인 계정
> * GitHub - 회사 계정
> * AWS - 운영 관리자
> * ZenDesk - 고객지원 관리자
>
> 아이디도 반드시 입력해 두면 로그인 과정에서 다른 계정의 인증 코드를 잘못 사용하는 실수를 줄일 수 있습니다.

***

### 4. 인증 키 등록하기 <a href="#id-4.-register-authentication-key" id="id-4.-register-authentication-key"></a>

인증 키는 다음 세 가지 방법 중 하나로 등록할 수 있습니다.

#### 방법 1. 인증 키 직접 입력하기 <a href="#method-1.-enter-the-authentication-key-manually" id="method-1.-enter-the-authentication-key-manually"></a>

사이트에서 **Setup key**, **Secret key**, **설정 키** 또는 **인증 키**라는 이름으로 제공하는 문자와 숫자의 조합을 복사합니다.

OfficePassword의 **인증 키** 입력란에 복사한 값을 붙여넣습니다.

입력할 때는 다음 사항을 확인하세요.

* 앞뒤에 불필요한 공백이 포함되지 않았는지 확인합니다.
* 사이트에서 제공한 값을 처음부터 끝까지 복사합니다.
* 현재 등록하려는 계정의 인증 키가 맞는지 확인합니다.
* 인증 키를 다른 사람에게 전달하거나 일반 메모에 저장하지 않습니다.

#### 방법 2. `otpauth://` 주소 붙여넣기 <a href="#method-2.-paste-otpauth-address" id="method-2.-paste-otpauth-address"></a>

사이트에서 `otpauth://`로 시작하는 주소를 제공하는 경우 해당 주소 전체를 복사하여 인증 키 입력란에 붙여넣습니다.

예를 들어 주소에는 서비스 이름, 계정 정보, 인증 키 및 코드 생성 설정이 함께 포함될 수 있습니다.

`otpauth://` 주소 역시 인증 키 원본을 포함하므로 외부에 노출하지 마세요.

#### 방법 3. QR 이미지 붙여넣기 <a href="#method-3.-paste-qr-image" id="method-3.-paste-qr-image"></a>

사이트의 2단계 인증 화면에 표시된 QR 코드를 캡처한 다음 OfficePassword에 붙여넣을 수도 있습니다.

1. 사이트에 표시된 QR 코드가 포함되도록 화면을 캡처합니다.
2. 캡처한 QR 이미지를 복사합니다.
3. OfficePassword의 **인증 키** 입력란을 클릭합니다.
4. Windows에서는 `Ctrl+V`, macOS에서는 `Command+V`를 누릅니다.
5. OfficePassword가 QR 코드를 읽으면 인증 키가 자동으로 입력됩니다.

처리 중에는 **QR 이미지를 읽고 있습니다…**&#xB77C;는 안내가 표시될 수 있습니다.

> **QR 코드를 인식하지 못하는 경우**
>
> * QR 코드 전체가 잘리지 않고 캡처되었는지 확인합니다.
> * QR 코드가 너무 작거나 흐리지 않은지 확인합니다.
> * QR 코드 주변에 다른 QR 코드가 함께 포함되지 않았는지 확인합니다.
> * 인식되지 않으면 사이트에 표시된 인증 키를 직접 복사하여 입력합니다.

다음과 같은 안내가 나타날 수도 있습니다. 그런 경우, 처음 인증 키를 등록했던 사이트에서 다시 확인해서 등록합니다.

* **이미지에서 QR 코드를 찾지 못했습니다.**
* **인증 코드 QR이 아닙니다.**
* **여러 계정이 담긴 QR입니다. 가져오기 메뉴를 이용해 주세요.**
* **지원하지 않는 인증 방식입니다(HOTP·Steam 등).**

***

### 5. 생성된 인증 코드 확인하기 <a href="#id-5.-check-the-generated-authentication-code" id="id-5.-check-the-generated-authentication-code"></a>

올바른 인증 키가 입력되면 OfficePassword에 6자리 미리보기 코드가 표시됩니다.

이 단계에서는 OfficePassword에 표시된 코드가 사이트에서 정상적으로 승인되는지 반드시 확인해야 합니다.

1. OfficePassword에 표시된 6자리 코드를 확인합니다.
2. 사이트의 2단계 인증 설정 화면으로 돌아갑니다.
3. 사이트의 인증 코드 입력란에 해당 코드를 입력합니다.
4. 사이트에서 확인 또는 활성화 버튼을 클릭합니다.
5. 사이트가 코드를 승인하는지 확인합니다.

> **매우 중요**
>
> OfficePassword에 6자리 숫자가 표시된다는 사실만으로 등록이 올바르다고 단정할 수 없습니다. 잘못 입력된 인증 키에서도 숫자가 생성될 수 있습니다.
>
> 반드시 그 코드를 원래 사이트에 입력하여 정상적으로 승인되는지 확인하세요.

***

### 6. OfficePassword에 저장하기 <a href="#id-6.-save-to-officepassword" id="id-6.-save-to-officepassword"></a>

사이트에서 인증 코드가 정상적으로 승인된 것을 확인한 다음 OfficePassword에서 **저장**을 클릭합니다.

인증 키를 새로 등록하거나 변경한 경우 다음 확인창이 표시됩니다.

> **인증 키를 확인하셨나요?**
>
> 인증 키가 등록 또는 변경되었습니다. 표시된 코드가 해당 사이트의 코드와 일치하는지 확인해 주세요. 키가 잘못되면 해당 사이트의 2단계 인증을 통과할 수 없습니다.

사이트에서 코드를 정상적으로 확인했다면 **예**를 클릭하여 저장합니다. 아직 확인하지 않았거나 코드가 일치하지 않는다면 **아니요**를 클릭하고 인증 키를 다시 확인합니다.

<figure><img src="https://3126530569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwcfZI3tFDjk54Cp5Ypy%2Fuploads%2FKPJ6swAVKfLASQNQNljz%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-09-11%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.42.17.png?alt=media&amp;token=5bdad9a7-b58c-462a-9674-582732afa87d" alt=""><figcaption><p><strong>인증 키 저장 전 확인 팝업</strong></p></figcaption></figure>

인증 키가 일반적인 길이인 16자보다 짧으면 추가 경고가 표시될 수 있습니다. 이 경고가 나타나더라도 저장할 수 있지만, 사이트에서 복사한 값이 누락되지 않았는지 다시 확인해야 합니다.

> **참고**
>
> 확인창은 인증 키를 새로 입력하거나 변경했을 때 표시됩니다. 제목이나 웹사이트 주소 등 인증 키 이외의 정보만 수정한 경우에는 표시되지 않을 수 있습니다.

***

### 7. 사이트의 2단계 인증 설정 완료하기 <a href="#id-7.-complete-the-sites-2-step-verification-setup" id="id-7.-complete-the-sites-2-step-verification-setup"></a>

OfficePassword 저장과 사이트의 2단계 인증 활성화는 서로 별개의 작업입니다.

OfficePassword에 인증 키를 저장했더라도 사이트의 설정 화면에서 최종 확인 또는 활성화 단계를 완료하지 않으면 2단계 인증이 켜지지 않을 수 있습니다.

사이트에서 다음 사항을 확인하세요.

* 2단계 인증이 **활성화됨** 또는 **Enabled** 상태인지 확인합니다.
* 제공되는 복구 코드를 안전한 장소에 보관합니다.
* 가능하면 로그아웃한 뒤 다시 로그인하여 인증 코드가 정상적으로 동작하는지 확인합니다.

***

## 로그인할 때 인증 코드 사용하기 <a href="#use-authentication-code-when-logging-in" id="use-authentication-code-when-logging-in"></a>

### 인증 코드 메뉴에서 확인하기 <a href="#check-in-the-authentication-code-menu" id="check-in-the-authentication-code-menu"></a>

OfficePassword 왼쪽 메뉴에서 방패 모양의 **인증 코드**를 클릭합니다. 인증 코드 메뉴 제목 옆의 정보 아이콘에 마우스 포인터를 올리면 다음과 같은 기능 안내를 확인할 수 있습니다.

> 목록에서 OTP 인증 코드를 바로 확인할 수 있습니다.

<figure><img src="https://3126530569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwcfZI3tFDjk54Cp5Ypy%2Fuploads%2FoQKGt1TYtU3n1P6yzaPe%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-08-13%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%204.06.16.png?alt=media&amp;token=bb37685b-7f3a-470c-945b-cc5e6c5750e4" alt="" width="264"><figcaption><p>인증 코드의 정보 아이콘 설명</p></figcaption></figure>

이 안내는 인증 코드 메뉴에서 각 레코드를 열지 않고도 코드 확인과 복사가 가능하다는 의미입니다.

인증 코드 메뉴의 오른쪽에는 인증 키가 등록된 카드나 목록들이 표시됩니다. 다른 패스워드 카드가 아닌 인증 키가 등록된 레코드만 모아서 표시되기 때문에 쉽게 인증키 항목에 접근할 수 있습니다. 인증 코드 메뉴 옆의 숫자는 등록된 인증 코드 카드 수를 나타냅니다.

<figure><img src="https://3126530569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwcfZI3tFDjk54Cp5Ypy%2Fuploads%2FJCgBteZob4KtI57BN7ZR%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-08-13%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%207.47.01.png?alt=media&amp;token=c30eba4d-7178-4480-8342-343fbc1ff0c4" alt=""><figcaption><p>인증 코드 메뉴에는 인증 코드 템플릿으로 생성된 카드만 표시됩니다.</p></figcaption></figure>

<figure><img src="https://3126530569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwcfZI3tFDjk54Cp5Ypy%2Fuploads%2F6PH1Yj28wvzgg6HWOyEx%2Fimage.png?alt=media&amp;token=79ddffdb-aa11-4831-8b03-fe77f73521fc" alt=""><figcaption><p>6자리 인증 코드 부분을 마우스로 누르면 클립보드로 복사됩니다.</p></figcaption></figure>

카드 목록의 각 레코드에서 현재 인증 코드를 바로 확인할 수 있습니다.

* 인증 코드 메뉴에서 보이는 등록 카드의 **인증 코드는 다른 뷰에서와는 달리 표시됩니다.**
* 코드를 클릭하면 현재 코드가 클립보드에 복사됩니다.
* 원형 카운트다운은 코드가 변경될 때까지 남은 시간을 나타냅니다.
* 남은 시간이 5초 이하가 되면 주황색으로 표시됩니다.

코드는 읽기 쉽도록 `123 456`처럼 세 자리씩 나뉘어 표시될 수 있지만, 사이트에는 공백 없이 입력해도 됩니다.

### 상세 화면에서 확인하기 <a href="#check-on-the-details-screen" id="check-on-the-details-screen"></a>

인증 코드 레코드를 선택하면 상세 화면이 열립니다.

상세 화면에서는 다음 정보를 확인할 수 있습니다.

<figure><img src="https://3126530569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwcfZI3tFDjk54Cp5Ypy%2Fuploads%2FW1FDi5iHf0u7QkzILemG%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-08-13%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%207.57.19.png?alt=media&amp;token=7523fa57-6181-434a-b9bc-35af8a760ff0" alt="" width="375"><figcaption><p><strong>GitHub 인증 코드와 카운트다운이 표시된 상세 화면</strong></p></figcaption></figure>

* 제목
* 아이디
* 웹사이트
* 현재 6자리 인증 코드
* 코드가 갱신될 때까지 남은 시간
* 인증 키를 다른 인증 앱에 등록할 수 있는 QR 보기 아이콘
* 레코드 상세 화면의 **인증 키** 필드에는 파란색 별표 모양의 **확장 프로그램 자동 입력 대상** 아이콘이 표시됩니다. 아이콘에 마우스 포인터를 올리면 다음 안내를 확인할 수 있습니다.

  > 확장 프로그램 자동 입력 대상

  이 아이콘은 해당 필드가 OfficePassword 브라우저 확장 프로그램의 자동 입력 대상으로 지정되어 있음을 나타냅니다.

<figure><img src="https://3126530569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwcfZI3tFDjk54Cp5Ypy%2Fuploads%2Fednma1NL85AzTmJUKHZq%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-08-13%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%204.05.47.png?alt=media&amp;token=9b3e22d8-b03e-443c-81f7-0855021b125b" alt="" width="375"><figcaption><p>확장 프로그램 자동 입력 아이콘의 정보 표시</p></figcaption></figure>

> 사이트의 2단계 인증 입력 화면에서 OfficePassword 브라우저 확장 프로그램을 사용하면, 해당 레코드의 현재 OTP 인증 코드를 사이트의 인증 코드 입력란에 자동으로 입력할 수 있습니다. 따라서 사용자는 OfficePassword 웹 화면을 다시 열어 코드를 확인하고 복사하지 않아도, 브라우저 확장 프로그램을 통해 인증 절차를 더 간편하게 진행할 수 있습니다.

로그인할 때는 다음과 같이 사용합니다.

1. 사이트에 아이디와 비밀번호를 입력합니다.
2. 사이트가 인증 코드를 요청하면 OfficePassword를 엽니다.
3. **인증 코드** 메뉴에서 해당 사이트 또는 계정을 선택합니다.
4. 표시된 6자리 코드를 확인하거나 복사합니다.
5. 사이트의 인증 코드 입력란에 붙여넣습니다.
6. 로그인 또는 확인을 선택합니다.

> **남은 시간이 짧다면**
>
> 카운트다운이 거의 끝났거나 주황색으로 표시된 경우에는 다음 코드로 변경될 때까지 잠시 기다린 다음 새 코드를 입력하는 것이 좋습니다. 코드를 입력하는 동안 유효 시간이 끝나면 사이트에서 잘못된 코드로 판단할 수 있습니다.

### 브라우저 확장 프로그램으로 인증 코드 입력하기 <a href="#entering-the-authentication-code-with-a-browser-extension" id="entering-the-authentication-code-with-a-browser-extension"></a>

1. 브라우저에서 로그인할 사이트를 엽니다.
2. 아이디와 비밀번호를 입력합니다.
3. 사이트에 OTP 또는 2단계 인증 코드 입력 화면이 나타나는지 확인합니다.
4. OfficePassword 브라우저 확장 프로그램을 엽니다.
5. 현재 사이트와 일치하는 계정을 선택합니다.
6. 확장 프로그램을 사용하여 인증 코드를 입력합니다.
7. 사이트에서 로그인 또는 확인을 클릭합니다.

사이트의 주소나 입력란 구조에 따라 자동 입력이 지원되지 않을 수 있습니다. 이 경우 OfficePassword의 인증 코드 메뉴에서 6자리 코드를 복사하여 직접 붙여넣으세요.

***

## QR 코드로 다른 인증 앱에 등록하기 <a href="#register-with-another-authentication-app-using-a-qr-code" id="register-with-another-authentication-app-using-a-qr-code"></a>

상세 화면에서 인증 코드 옆의 작은 **QR 아이콘**을 클릭하면 현재 인증 키가 포함된 QR 코드가 표시됩니다.

Google Authenticator, Microsoft Authenticator 등 다른 인증 앱으로 같은 계정을 옮기거나 추가하려는 경우 해당 앱에서 이 QR 코드를 스캔할 수 있습니다.

같은 인증 키가 등록된 앱들은 같은 시점에 동일한 인증 코드를 생성합니다.

<figure><img src="https://3126530569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNwcfZI3tFDjk54Cp5Ypy%2Fuploads%2FY5DKpgOJpLwSgZqsrD7W%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-09-11%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%201.44.07.png?alt=media&amp;token=012cdb72-3fae-4054-aaf4-d3dadfe78c5d" alt=""><figcaption><p><strong>인증 코드 QR 보기 창</strong></p></figcaption></figure>

QR 창에는 다음 안내가 표시됩니다.

> 이 QR은 인증 키 원본입니다. 화면 공유나 캡처에 주의하세요.

> 다른 인증 앱에서 이 QR을 스캔하면 같은 코드가 생성됩니다.

### QR 코드 보안 주의사항 <a href="#qr-code-security-precautions" id="qr-code-security-precautions"></a>

QR 코드는 단순한 로그인용 6자리 코드가 아니라 **인증 키 원본을 포함한 정보**입니다.

누군가 QR 코드를 촬영하거나 전달받으면 자신의 인증 앱에 등록하여 동일한 코드를 계속 생성할 수 있습니다.

따라서 다음 사항을 반드시 지켜 주세요.

* QR 코드가 열린 상태에서 화면을 공유하지 않습니다.
* QR 코드 화면을 캡처하여 메신저나 이메일로 전달하지 않습니다.
* QR 이미지 파일을 일반 폴더나 공동 저장소에 보관하지 않습니다.
* 다른 인증 앱에 등록한 뒤 QR 창을 바로 닫습니다.
* QR 코드가 노출되었다고 의심되면 해당 사이트에서 인증 키를 재발급합니다.

***

## 중복 인증 키 확인하기 <a href="#check-duplicate-authentication-keys" id="check-duplicate-authentication-keys"></a>

동일한 인증 키가 다른 레코드에도 저장되어 있으면 주황색 경고 아이콘이 표시됩니다.

아이콘에 마우스를 올리면 다음과 같이 중복된 레코드를 확인할 수 있습니다.

> 중복된 인증 키입니다. 같은 키: `{상대 레코드 이름}`

같은 서비스를 여러 사람이 사용하거나 동일한 코드를 의도적으로 공유하는 경우에는 중복이 정상일 수 있습니다. 그러나 실수로 같은 인증 키를 여러 계정에 등록한 것은 아닌지 확인해야 합니다.

중복 여부는 인증 키 값이 완전히 같을 때만 확인됩니다. 같은 사이트라도 인증 키를 새로 발급하여 값이 달라지면 중복으로 표시되지 않습니다.

***

## 인증 코드를 공유하는 경우 <a href="#if-you-share-the-authentication-code" id="if-you-share-the-authentication-code"></a>

인증 코드 레코드를 다른 사용자와 공유하면 공유받은 사용자도 동일한 인증 코드를 확인할 수 있습니다.

이는 여러 담당자가 하나의 공용 관리 계정에 로그인해야 하는 경우에 사용할 수 있습니다. 예를 들어 회사의 공용 서비스 관리자 계정이나 공동 운영 계정의 인증 코드를 지정된 담당자들과 공유할 수 있습니다.

다만 공유받은 사용자는 해당 서비스의 2단계 인증을 통과할 수 있으므로, 반드시 업무상 필요한 사용자에게만 공유해야 합니다.

* 공유 대상이 올바른지 확인합니다.
* 퇴사자나 담당 업무가 변경된 사용자의 공유 권한을 해제합니다.
* 개인 계정의 인증 코드는 공유하지 않는 것을 권장합니다.
* 계정 비밀번호와 인증 코드를 함께 공유할 때는 접근 권한을 더욱 엄격하게 관리합니다.

> **보안 안내**
>
> 2단계 인증은 비밀번호와 인증 수단이 분리되어 있을 때 더 높은 보안 효과를 제공합니다. 공용 계정 운영상 필요한 경우가 아니라면, 계정 비밀번호와 인증 코드를 불필요하게 여러 사용자에게 공유하지 마세요.

***

## 오피스패스워드가 잠겨 있을 때 <a href="#when-the-officepassword-is-locked" id="when-the-officepassword-is-locked"></a>

인증 키는 암호화된 민감 정보이므로 OfficePassword 금고가 잠긴 상태에서는 인증 코드를 생성할 수 없습니다.

코드 대신 마스터 비밀번호 입력 안내가 표시되면 마스터 비밀번호를 입력하여 오피스패스워드를 여세요. 금고가 열리면 인증 코드가 다시 표시됩니다.

OfficePassword 관리자나 서버는 사용자의 마스터 비밀번호 또는 인증 키 원문을 확인할 수 없습니다.

***

## 인증 코드가 맞지 않을 때 <a href="#when-the-authentication-code-is-incorrect" id="when-the-authentication-code-is-incorrect"></a>

사이트에서 **코드가 올바르지 않습니다**, **Invalid code** 또는 이와 유사한 메시지가 표시되면 다음 항목을 순서대로 확인하세요.

### 1. 올바른 계정의 코드인지 확인하기 <a href="#id-1.-check-if-it-is-the-code-for-the-correct-account" id="id-1.-check-if-it-is-the-code-for-the-correct-account"></a>

같은 사이트에 여러 계정을 사용하는 경우 다른 계정의 코드를 입력했을 수 있습니다.

OfficePassword의 제목과 아이디를 확인한 다음 현재 로그인하려는 계정과 일치하는지 확인하세요.

### 2. 새 코드로 다시 시도하기 <a href="#id-2.-try-again-with-the-new-code" id="id-2.-try-again-with-the-new-code"></a>

코드의 남은 시간이 거의 끝난 상태였다면 입력하는 도중 코드가 만료되었을 수 있습니다.

새 코드가 표시될 때까지 기다렸다가 다시 입력하세요.

### 3. 기기 시간 확인하기 <a href="#id-3.-check-device-time" id="id-3.-check-device-time"></a>

TOTP는 현재 시간을 기준으로 계산됩니다. 컴퓨터 또는 모바일 기기의 시간이 크게 어긋나면 올바른 인증 키가 등록되어 있어도 사이트에서 코드를 거부할 수 있습니다.

기기의 날짜 및 시간 설정에서 **자동으로 시간 설정**을 켜세요.

기기 시간과 서버 시간이 크게 차이 나는 경우 OfficePassword에는 다음과 같은 안내가 표시될 수 있습니다.

> 기기 시간이 서버와 `{N}`초 차이 납니다. 코드는 자동 보정되지만, 기기의 ‘자동 시간 설정’을 켜 주세요.

### 4. 인증 키를 다시 확인하기 <a href="#id-4.-check-the-authentication-key-again" id="id-4.-check-the-authentication-key-again"></a>

사이트에서 제공한 인증 키의 일부가 누락되었거나 다른 계정의 키를 입력하지 않았는지 확인합니다.

인증 키를 변경한 경우에는 OfficePassword에 표시되는 새 코드를 사이트에서 다시 확인해야 합니다.

### 5. 사이트에서 2단계 인증 상태 확인하기 <a href="#id-5.-check-the-2-step-verification-status-on-the-site" id="id-5.-check-the-2-step-verification-status-on-the-site"></a>

사이트의 2단계 인증 설정이 완료되지 않았거나, 인증 키를 재발급하면서 이전 키가 폐기되었을 수 있습니다.

사이트의 보안 설정을 열어 현재 2단계 인증 상태를 확인하세요.

***

## 인증 키를 변경하거나 다시 등록할 때 <a href="#when-changing-or-re-registering-the-authentication-key" id="when-changing-or-re-registering-the-authentication-key"></a>

사이트에서 2단계 인증을 초기화하거나 인증 앱을 다시 설정하면 새로운 인증 키가 발급됩니다.

이 경우 이전 인증 키로 생성되는 코드는 더 이상 사용할 수 없습니다.

1. 사이트에서 새로운 인증 키 또는 QR 코드를 발급합니다.
2. OfficePassword에서 해당 레코드의 **편집**을 클릭합니다.
3. 기존 인증 키를 새 인증 키로 교체합니다.
4. 새로 생성된 코드를 사이트에 입력하여 확인합니다.
5. OfficePassword에서 저장합니다.
6. 확인창에서 사이트와 코드가 일치하는지 확인한 후 **예**를 선택합니다.

인증 키를 변경하기 전에 기존 2단계 인증을 해제하면 계정에 다시 로그인하지 못할 수 있으므로, 사이트에서 안내하는 순서에 따라 진행하세요.

***

## 알아두어야 할 제한 사항 <a href="#limitations-to-be-aware-of" id="limitations-to-be-aware-of"></a>

* TOTP 방식의 인증 코드만 지원합니다.
* HOTP 및 Steam 인증 방식은 지원하지 않습니다.
* 여러 계정이 하나의 QR에 포함된 경우 생성 화면에서 바로 등록할 수 없습니다. 안내에 따라 가져오기 메뉴를 사용해야 합니다.
* 인증 키는 암호화되어 저장되며 검색 대상에 포함되지 않습니다.
* 인증 코드 메뉴 아래의 **만료**는 인증 코드의 유효 시간이 아닙니다. 비밀번호 사용 기한이 지난 레코드를 모아 보여주는 별도의 메뉴입니다.
* 인증 코드가 숫자로 표시된 후에는 코드가 갱신되더라도 자동으로 다시 가려지지 않습니다. 필요한 경우 눈 모양 아이콘을 다시 클릭하여 가리세요.
* 사이트에서 발급한 복구 코드는 OfficePassword의 인증 코드와 별개의 정보입니다. 사이트의 안내에 따라 안전하게 보관하세요.

***

## 등록부터 로그인까지 한눈에 보기 <a href="#view-everything-from-registration-to-login-at-a-glance" id="view-everything-from-registration-to-login-at-a-glance"></a>

### 처음 등록할 때 <a href="#when-you-first-register" id="when-you-first-register"></a>

1. 사이트의 보안 설정에서 2단계 인증을 시작합니다.
2. 인증 앱 방식을 선택합니다.
3. 사이트에서 QR 코드 또는 인증 키를 확인합니다.
4. OfficePassword에서 **생성 > 인증 코드**를 선택합니다.
5. 제목, 아이디 및 웹사이트를 입력합니다.
6. 인증 키를 입력하거나 QR 이미지를 붙여넣습니다.
7. OfficePassword에 생성된 코드를 사이트에 입력합니다.
8. 사이트에서 코드가 승인되는지 확인합니다.
9. OfficePassword에서 저장합니다.
10. 사이트의 2단계 인증 활성화가 완료되었는지 확인합니다.
11. 사이트에서 제공하는 복구 코드를 안전하게 보관합니다.

### 이후 로그인할 때 <a href="#when-you-log-in-later" id="when-you-log-in-later"></a>

1. 사이트에 아이디와 비밀번호를 입력합니다.
2. OfficePassword의 **인증 코드** 메뉴를 엽니다.
3. 해당 사이트와 아이디가 맞는지 확인합니다.
4. 현재 6자리 인증 코드를 복사합니다.
5. 사이트에 코드를 입력하여 로그인합니다.ㅐ


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.officepassword.kr/using-officepassword/create-a-password/how-to-use-the-authentication-code.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.