로그인과 OTP 앱

포털 화면은 개발 중입니다. 화면의 낱말과 배치는 바뀔 수 있고, 단추가 실행하는 명령은 이미 만들어져 있습니다.

관리자가 계정을 만들면 로그인 안내문을 받습니다. 처음 로그인할 때 새 비밀번호를 정하고, 기관이 요구하면 그 전에 휴대폰 OTP 앱을 등록합니다.

받는 것

관리자가 건네는 로그인 안내문에는 세 가지가 적혀 있습니다.

• 포털 주소. 예를 들면 https://app.example.org 같은 주소입니다.
• 내 아이디
• 임시 비밀번호와 그 기한. 기본으로 72시간 동안 쓸 수 있습니다.

기한이 지났으면 관리자에게 임시 비밀번호를 다시 만들어 달라고 하세요.

처음 로그인하기

1. 1단계: 로그인

   포털 주소를 열고 「아이디」와 「비밀번호」를 넣은 다음 [로그인]을 누릅니다. 화면 오른쪽 위에서 한국어와 English를 바꿀 수 있습니다. 처음에는 브라우저의 언어를 따릅니다.

2. 2단계: OTP 앱 등록 (요구하는 기관만)

   기관이 OTP 앱을 요구하면(인터넷에 공개한 설치) 「OTP 앱 등록」 화면이 먼저 나옵니다: 「이 기관은 모든 계정에 OTP 앱 코드를 요구합니다.」 아래 OTP 앱 등록하기의 1~3단계대로 앱을 등록하고 [확인]을 누르면, 단추가 [비밀번호 바꾸기]로 바뀝니다. 그 단추를 누릅니다.

   요구하지 않는 기관이면 이 단계는 없습니다. OTP 앱은 나중에 [내 계정]에서 원할 때 등록합니다.

3. 3단계: 새 비밀번호 정하기

   「비밀번호 바꾸기」 화면이 이 안내와 함께 나옵니다: 「처음 로그인했거나 관리자가 임시 비밀번호를 만들었습니다. 새 비밀번호를 정해야 계속할 수 있습니다.」

   「지금 비밀번호」에 임시 비밀번호를, 「새 비밀번호」와 「새 비밀번호 한 번 더」에 새 비밀번호를 넣고 [비밀번호 바꾸기]를 누릅니다.

4. 4단계: 새 비밀번호로 다시 로그인

   「비밀번호를 바꿨습니다. 새 비밀번호로 다시 로그인하세요.」가 나오면 새 비밀번호로 로그인합니다. OTP 앱을 등록했으면 코드도 넣습니다.

로그인을 마치면 [내 작업공간]이 열립니다.

OTP 앱 등록하기

OTP 앱을 등록하면 로그인할 때 비밀번호 다음에 휴대폰 OTP 앱에 보이는 6자리 코드를 넣습니다. 인터넷에 공개한 설치에서는 모든 계정이 등록해야 합니다. 그렇지 않은 설치에서는 [내 계정]의 「OTP 앱」 구역에서 원할 때 등록합니다.

1. 1단계: 휴대폰에 OTP 앱 준비

   Google Authenticator, Microsoft Authenticator처럼 6자리 코드를 보여 주는 OTP 앱을 휴대폰에 설치합니다.

2. 2단계: [등록] 누르기

   [등록]을 누르면 QR 코드와 등록 키가 나옵니다. 「휴대폰의 OTP 앱(Google Authenticator, Microsoft Authenticator 등)으로 찍으세요.」 QR 코드를 찍을 수 없으면 「찍을 수 없으면 이 키를 넣으세요」 아래의 키를 앱에 직접 넣습니다.

3. 3단계: 코드 넣고 [확인]

   「앱에 보이는 6자리 코드」에 앱의 코드를 넣고 [확인]을 누릅니다. 「OTP 앱을 등록했습니다. 다음 로그인부터 코드를 묻습니다.」가 나옵니다.

4. 4단계: 다시 로그인

   [다시 로그인]을 누르고 비밀번호와 코드로 로그인합니다. 등록을 확인하면 이 탭을 포함해 내 로그인 세션이 모두 끝납니다. 처음 로그인하는 중이라 비밀번호를 바꿔야 할 때만 세션이 이어지고, [비밀번호 바꾸기]로 갑니다.

[내 계정]에서 등록하면 화면 아래 콘솔에 이런 명령이 나옵니다. 로그인 화면에서 이어서 하는 등록에는 콘솔이 없습니다.

Started setting up the authenticator app: kimAdd it to the app with the setup link (as a QR code) or the setup key, then confirm with: synapse user authenticator confirm

표준 입력: (숨김)Confirmed the authenticator app: kimSign-ins now ask for its code.Signed out 1 session. Sign in again with your password and a code.

코드로 로그인하기

OTP 앱을 등록한 계정은 비밀번호가 맞으면 코드를 묻습니다: 「휴대폰의 OTP 앱을 열고 이 계정의 코드를 넣으세요.」 앱에 지금 보이는 6자리 코드를 넣고 [확인]을 누릅니다.

한 번 쓴 코드는 다시 받지 않습니다. 같은 코드로 다시 해야 하면 앱의 코드가 바뀔 때까지 기다리세요.

로그인 화면에 「비밀번호는 맞았지만 맞는 코드 없이 끝난 로그인」이 있었다고 나오면, 누군가 내 비밀번호로 로그인하려 했다는 뜻일 수 있습니다. 본인이 아니면 비밀번호를 바꾸세요.

코드를 한 번 더 넣는 일

OTP 앱을 등록한 계정은 SSH 키, API 토큰, 계정과 임시 비밀번호를 바꾸려면 10분 안에 넣은 코드가 필요합니다. 그런 단추를 누르면 「코드로 확인」 창이 열리고, 앱의 코드를 넣으면 그 일을 이어서 합니다.

휴대폰을 잃어버리거나 바꿀 때

관리자에게 OTP 앱 초기화를 요청하세요. 복구 코드는 없습니다. 휴대폰을 바꾸는 것도 관리자가 초기화한 다음 새로 등록합니다. 초기화하면 비밀번호, SSH 키, API 토큰도 새로 정해야 합니다.

로그인이 유지되는 시간

로그인은 길어야 12시간 유지되고, 60분 동안 쓰지 않으면 끝납니다(기본값). IDE 탭이 열려 있으면 쓰는 중으로 봅니다. 다시 로그인해도 작업공간의 터미널과 돌던 작업은 그대로입니다.

비밀번호 바꾸기

[내 계정]에서 비밀번호를 바꿉니다. 바꾸면 모든 로그인 세션이 끝나고, 내 SSH 키와 API 토큰이 폐기됩니다. 「API 토큰과 SSH 키는 그대로 두기」를 체크하면 남겨 둘 수 있지만, 누가 비밀번호를 알았을 수 있어서 바꾸는 것이면 체크하지 마세요.

로그인이 안 될 때

화면에는 무엇이 안 됐는지 한 문장이 나오고, 「사유:」 뒤에 할 일이 나옵니다.