버전 1.0.0-alpha.1최신
챕터 2.12
첫 실행
소유권이 등록되지 않은 설치 환경에서 사용자들이 업무를 시작하기까지의 과정입니다. 등록 코드를 생성하고, 브라우저에서 설치 환경의 소유권을 등록하고, 패스키로 첫 번째 관리자를 생성한 다음, 회사 로그인을 연결하고 다른 모든 사람을 초대합니다.
이 페이지는 AI에 의해 영어 원문에서 번역되었습니다. 불명확한 내용이 있는 경우 영어 페이지를 기준으로 삼으십시오. 이 페이지를 영어로 읽기

설치가 완료되면, 해당 설치 환경은 누구에게도 속하지 않습니다. 조직도, 사람도, 세션도 없으며 아무도 로그인할 수 없습니다. 방금 생성된 설치 환경과 통신하고 있음을 브라우저에서 증명할 한 사람을 기다립니다. Harrow Port Authority에서는 그 사람이 IT 총괄인 Aoife Brennan이었고, 터미널 옆에는 Tomás Reilly가 함께했습니다. 이 장에서는 이들의 첫 20분을 따라갑니다.
순서는 고정되어 있으며, 각 단계가 끝나면 이전 단계는 영구적으로 닫힙니다. 설치 환경의 소유권을 등록하고, 첫 번째 관리자와 조직을 생성하고, 패스키를 설정한 뒤 Today 페이지에 도달합니다. 그 후에는 원하는 순서에 따라 6가지 준비 사항, 회사 로그인, 그리고 다른 모든 사용자 초대를 진행합니다.
등록 코드 생성
소유권 등록 코드는 브라우저 앞의 사람이 클러스터에 액세스할 수 있는 사람의 터미널도 볼 수 있음을 증명합니다. 오직 그러한 사람만이 코드를 생성할 수 있습니다. kubeconfig가 클러스터에 도달하는 곳에서 다음을 실행하십시오:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code은 설치 환경의 키 서비스인 nexus-keys에 코드를 생성하도록 요청합니다. nexusctl이 없으면 키 서비스의 자체 파드(pod)에서 동일한 명령이 실행됩니다:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"--source은 누가 코드를 만들었는지 나타내는 몇 마디 단어입니다. 소유권 등록 페이지의 "Made by" 아래에 이 내용이 표시되므로, 등록하는 사람은 코드가 어디에서 왔는지 알 수 있습니다.
Code 7KQM-4TXD-PL9R works once, for 30 minutes, until 09:55 · 5 tries
Fingerprint of this installation, to compare in the browser:
3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7
코드에 관해서는 세 가지 사항이 중요합니다.
- 30분 동안 유효합니다. 누군가의 어깨너머로 본 코드는 곧 쓸모없어집니다.
- 5번의 시도를 허용합니다. 다섯 번째 잘못된 시도 후에는 남은 시간과 관계없이 소진됩니다.
- 한 사람을 위한 것입니다. 입력한 이메일은 첫 번째 관리자의 이메일이 됩니다. 이 이메일은 소유권 등록과 함께 전달되며, 첫 번째 관리자 양식에는 다시 입력할 필요 없이 고정된 값으로 표시됩니다.
핑거프린트는 네 글자씩 여덟 그룹으로 이루어져 있으며, 설치 환경 자체의 고유 식별자입니다. 화면에 그대로 두십시오. 브라우저에서 그룹별로 하나씩 비교하게 됩니다.
설치 환경 소유권 등록
- 첫 번째 관리자로서 사용할 컴퓨터에서 콘솔의 설치 주소(여기서는
https://console.harrow.example/install)를 엽니다. 설치 환경의 상태에 맞는 올바른 페이지로 이동합니다. 열려 있는 동안에는 소유권 등록 페이지로, 등록된 후에는 첫 번째 관리자 페이지로, 이미 로그인한 경우에는 콘솔로 이동합니다. - Claim this installation에서 Group one, Group two, Group three에 네 글자씩 한 그룹을 각각 입력하여 코드를 입력합니다.
- 페이지의 Fingerprint of this installation을 터미널과 여덟 그룹 모두 하나씩 비교합니다.
- 모든 그룹이 일치하면 All eight groups match what my terminal shows에 체크 표시를 합니다.
- Claim this installation을 누르면 페이지에서 소유권 등록을 확인하고 첫 번째 관리자 단계로 이동합니다.
소유권 등록은 세 가지 작업을 수행합니다. 이 브라우저를 첫 번째 관리자를 생성할 수 있는 유일한 곳으로 만듭니다. 감사 로그에 누가 언제 설치 환경의 소유권을 등록했는지 기록합니다. 그리고 소유권 등록 페이지를 영구적으로 비활성화합니다. 그때부터 소유권 등록 주소는 설치 환경의 소유권이 이미 등록되었다고 응답합니다.
핑거프린트가 일치하지 않으면 중단하십시오
핑거프린트가 다르다는 것은 이 주소에서 다른 설치 환경이 응답하고 있음을 의미합니다. 잘못 입력된 주소이거나, 오래된 DNS(Domain Name System) 레코드이거나, 첫 번째 관리자를 가로채기 위해 설정된 시스템일 수 있습니다. 소유권을 등록하면 해당 시스템이 귀하의 조직을 보유하게 됩니다.
소유권을 등록하지 마시고, 해당 페이지에 코드를 입력하지 마십시오. 페이지를 닫은 후 두 가지를 확인하십시오: console.harrow.example이 귀하의 인그레스(ingress)로 확인되는지, 그리고 브라우저가 표시하는 인증서가 예상하는 CA(인증 기관)에서 발급되었는지 확인하십시오. 귀하의 설치 환경은 변경되지 않았으며 여전히 소유권이 등록되지 않은 상태입니다.
설치 환경의 것이 아닌 핑거프린트로 소유권 등록 요청이 전송되면 키 서비스는 CLAIM_FINGERPRINT_MISMATCH (403)과 함께 이를 거부합니다. 아무것도 등록되지 않습니다. 그런 다음 페이지는 두 핑거프린트를 나란히 표시하여 다른 그룹을 표시하고, 주소와 인증서를 확인하는 단계를 안내합니다.
첫 번째 관리자 및 조직 생성
이어지는 페이지의 제목은 "Two short forms, then you are in"입니다. 첫 번째 관리자는 다른 모든 사용자를 추가할 수 있으며, 여기에 있는 거의 모든 항목은 나중에 변경할 수 있습니다. 두 가지는 변경할 수 없으며 페이지에 표시되어 있습니다.
| 필드 | 입력 항목 | 나중에 변경할 수 있습니까? |
|---|---|---|
| 성명 | 귀하의 이름 | 예 |
| 업무용 이메일 | 소유권 등록 코드가 생성된 대상 주소로, 화면에 표시되며 다시 입력하지 않음 | 관리자의 주소입니다 |
| Nexus 내 역할 | 조직 관리자. 첫 번째 사람은 항상 관리자입니다. | 여기서 선택하지 않음 |
| 2차 확인 | 이 노트북의 패스키 | 예, 더 추가할 수 있습니다 |
| Name (조직 이름) | Harrow Port Authority | 예 |
| 국가 | 조직의 소재지 | 예 |
| 주소에 사용할 약칭 | 이름을 바탕으로 생성됨(예: harrow-port-authority) |
아니요. 링크 및 내보내기에서 사용합니다. |
| 데이터 보관 위치 | 이 설치 환경 | 아니요. 나중에 변경하려면 새로 설치해야 합니다. |
| 언어 및 날짜 | 영어(영국), 오늘 날짜 표시 | 예 |
| 시간대 | 서버의 시간대 | 각 사용자는 자신의 시간대로 시간을 봅니다 |
짧은 이름은 악센트가 제거된 조직 이름에서 만들어지며, 최대 100자의 소문자, 숫자 및 하이픈으로 구성됩니다. 아무 버튼이나 누르기 전에 이를 확인하십시오. 조직이 존재하는 한 사람들이 공유하는 모든 링크와 생성하는 모든 내보내기에 나타납니다.
또한 이 페이지에서 비밀번호를 설정합니다. 비밀번호만으로는 절대 충분하지 않습니다. 관리자는 비밀번호만으로 로그인하지 않습니다. 아래의 2차 확인이 귀하를 로그인시킵니다.
비상용 관리자 로그인도 동시에 생성됩니다. 금고 보관용으로 봉인되어 한 번 인쇄됩니다. 회사 로그인이 중단되었을 때만 작동하며, 모든 사용 내역은 기록되고 모든 관리자에게 공지됩니다. 인쇄한 당일에 금고에 보관하십시오.
또한 페이지에는 Adverant에 귀하의 신원이 전달되지 않는다고 명시되어 있습니다. 이 세부 정보는 설치 환경에 남아 있습니다. 라이선스에는 회사 이름만 기재되며, 회사 소속 개인의 이름은 절대 기재되지 않습니다.
Create and sign in을 누릅니다. 관리자와 조직을 생성하는 데 몇 초가 걸립니다. 페이지가 "Made for aoife.brennan@harrow.example. Now set up your passkey: it is how you sign in."이라고 응답합니다.
패스키: 두 번째 확인
- Set up the passkey and sign in을 누릅니다.
- 브라우저에서 패스키를 생성하도록 요청합니다. Touch ID 또는 Windows Hello가 있는 노트북에서는 지문, 얼굴 또는 PIN으로 확인하십시오. 컴퓨터 자체에서 패스키를 만들 수 없는 경우 브라우저에 QR(빠른 응답) 코드가 표시됩니다. 휴대폰 카메라로 코드를 비추고 휴대폰의 안내를 따르십시오.
- 페이지는 "패스키가 설정되었으며 aoife.brennan@harrow.example 계정으로 로그인되었습니다."라고 응답하며 콘솔을 엽니다.
Create and sign in을 누른 후 동일한 브라우저에서 10분 이내에 패스키를 생성해야 합니다. 그 후에는 설정이 닫히고 관리자는 패스키 없이 존재하게 됩니다. 아래의 재시도 항목에 설명된 대로 운영자가 도와야 합니다.
이제부터 첫 번째 관리자는 해당 패스키로 로그인합니다. 전체 관리자의 비밀번호만 단독으로 입력해서는 절대 세션이 만들어지지 않으며, 로그인 서비스는 2차 확인 요청으로 응답합니다. 이는 설계상의 특성이며 패스키가 중요한 이유입니다. 패스키를 분실하면 들어갈 방법을 잃게 되므로, 첫날에 휴대폰이나 보안 키에 두 번째 패스키를 추가하십시오.
나중에 사용자들은 조직이 허용하는 방식에 따라 패스키, Google, GitHub 또는 회사 로그인으로 설치 환경에 로그인합니다.
| 코드 | 의미 | 조치 방법 |
|---|---|---|
PASSKEY_UNSUPPORTED |
이 브라우저는 패스키를 만들 수 없습니다. 아무것도 설정되지 않았습니다. | 동일한 컴퓨터에서 패스키를 지원하는 브라우저로 페이지를 여십시오. |
PASSKEY_CANCELLED |
프롬프트가 닫혔거나 제시간에 아무것도 선택하지 않았습니다. 아무것도 전송되지 않았습니다. | 버튼을 다시 누르십시오. |
첫 번째 Today 페이지
콘솔은 Today에서 열리며, 첫날에는 거의 모든 영역이 비어 있습니다. 각 빈 영역에는 거기에 무엇이 나타날지 설명되어 있고 이를 시작하는 버튼이 제공됩니다. 예를 들어 "Needs an administrator"에는 사람들이 합류하면 요청이 거기에 대기할 것이라고 나와 있으며, 그 옆에는 Invite people이 있습니다. 설정 체크리스트에는 순서에 상관없이 완료된 단계의 수가 표시됩니다. 유일한 실제 기록인 설정 자체는 이미 "What changed" 아래에 있습니다(설치 환경 설정 완료 및 첫 번째 관리자의 패스키 생성 완료).
누군가 로그인하기 전에 해야 할 여섯 가지 작업
Six things before anyone signs in 페이지에는 사용자를 초대하기 전에 충족되어야 하는 사항이 나열되어 있습니다. 이는 마법사가 아닙니다. 어떤 순서로든 수행하면 페이지에서 이를 집계합니다("Three of six true").
| 항목 | 충족 조건 |
|---|---|
| 라이선스 | Enterprise 라이선스 가져오기 완료. 라이선스에 관한 2.13장을 참조하십시오. Community는 라이선스가 필요하지 않습니다. |
| 주소 및 인증서 | 공개 주소가 체인이 완전한 인증서로 응답함. |
| 백업 | 쓰기 가능한 대상과 함께 백업 일정이 설정됨. |
| 회사 계정 로그인 | 연결 및 테스트 완료. 그때까지 사용자는 패스키를 사용합니다. |
| 메일 | 메일 서버 설정 완료. 그때까지는 초대장을 보낼 수 없습니다. |
| AI 모델 | AI(인공지능) 모델: 조직 모델 키 또는 자체 하드웨어의 모델. 그때까지 어시스턴트는 대기합니다. AI 제공업체 및 모델에 관한 2.14장을 참조하십시오. |
여섯 가지가 모두 충족되면 Invite people이 열립니다.
동일한 페이지에 사람들이 로그인하면 고정되는 항목과 각각의 이유가 나열되어 있습니다. 즉, 주소의 짧은 이름, 데이터 보관 위치, 키 관리인(키는 소프트웨어 관리인에서 하드웨어로 이동할 수 있지만 다시 되돌릴 수는 없음)입니다. 조직 이름도 변경할 수는 있지만 확인해 볼 가치가 있기 때문에 함께 나열됩니다.
Nexus는 조직에 모델이 있을 때까지 누구의 AI 요청에도 응답하지 않습니다. 설치 환경 이면에 공유 키나 대체 수단이 없으므로, 모델 키가 없는 조직은 관리자에게 무엇을 추가해야 하는지 알려주는 단순한 거부 응답을 받게 됩니다.
회사 로그인
대부분의 조직은 사람들이 이미 가지고 있는 계정으로 로그인하기를 원합니다. 회사 로그인 페이지에서 자격 증명 공급자(IdP)를 연결하십시오. Community에서는 OIDC(OpenID Connect)를 통해, Enterprise에서는 OIDC 또는 SAML(Security Assertion Markup Language)을 통해 연결합니다.
- 공급자와 사용하는 표준을 선택합니다.
- 자격 증명 공급자가 제공한 애플리케이션 ID와 애플리케이션 시크릿을 입력합니다. 시크릿은 저장한 후에는 다시 표시되지 않습니다.
- 누가 로그인할 수 있는지 지정합니다(예:
@harrow.example주소를 가진 모든 사람). - Test sign-in을 누르고 본인으로 로그인합니다. 결과에는 누가 로그인했고 공급자가 무엇을 보냈는지 텍스트로 표시됩니다.
- 저장합니다.
Community는 조직에 대해 하나의 회사 로그인을 제공합니다. Enterprise는 강제 적용 및 디렉터리 동기화를 추가합니다. 강제 적용은 비밀번호를 비활성화하므로 모든 사람이 회사 로그인을 사용해야 하며, 비밀번호 시도는 SSO_REQUIRED 및 올바른 진입 경로로 안내하는 버튼과 함께 거부됩니다. 디렉터리 동기화는 15분마다 디렉터리에서 사용자와 그룹을 복사하며, 지정된 한 그룹의 구성원을 관리자로 만들 수 있습니다.
회사 로그인이 응답을 멈추면 이미 로그인한 사람들은 로그인 상태를 유지하고, 새로운 로그인은 IDP_UNREACHABLE (503)과 함께 거부됩니다. 이때 관리자는 금고에서 꺼낸 비상용 관리자 로그인을 패스키와 함께 사용할 수 있습니다. 모든 사용 내역은 감사 로그에 기록되고 모든 관리자에게 공지되며, 4시간 후 또는 회사 로그인이 복구되면 종료됩니다.
사람 초대
메일이 설정되면 People 페이지에서 사람들을 초대하십시오. 각 사람에게 이메일과 역할을 부여합니다:
- Member는 조직이 가진 모든 것을 사용하며 설정을 변경하지 않습니다.
- Administrator는 사람, 모델, 예산 및 설정도 관리합니다.
초대는 7일 동안 유효합니다. 초대받은 사람은 초대를 열고 누가 초대했는지, 자신의 역할과 무엇을 보게 될지 확인한 후 로그인합니다. 첫 번째 로그인 시 2차 확인이 요청됩니다.
초대받은 구성원은 콘솔에 로그인하여 역할이 허용하는 대로 Today, 어시스턴트, 팀 채팅, 파일 및 검색, 노트북, 에이전트 및 워크플로 등의 일상 업무를 수행합니다. 관리자는 관리 페이지도 볼 수 있습니다. 관리자의 페이지를 여는 구성원에게는 "Not an administrator" 페이지가 표시됩니다. 이 페이지는 설정을 읽기 전용으로 보여주고 그 이유를 설명하며 관리자에게 요청하는 기능을 제공합니다.
가입에는 승인이 필요합니다
사람들은 직접 가입하여 합류를 요청할 수도 있습니다. 설치 환경에서 외부인의 가입은 작동하는 계정을 생성하지 않습니다. nexus-auth는 이를 SIGNUP_REQUIRES_APPROVAL (403)으로 거부하고 관리자의 승인을 위해 보류합니다.
Adverant의 호스팅 서비스에는 다른 두 가지 가입 제어 기능이 존재하지만 모든 설치 환경에서는 꺼져 있으며, 이를 켤 수 있는 설정값도 없습니다. 인터넷 CAPTCHA는 가입할 때마다 인터넷이 필요할 것입니다. 가입 네트워크 화면은 설치 환경에 포함되지 않은 라이선스 위치 정보 데이터베이스가 필요할 것입니다. 승인이 곧 설치 환경의 관문입니다.
재시도, 만료된 코드 및 기타 거부
첫 실행에서의 모든 거부는 무슨 일이 일어났는지, 실제로 변경된 것이 없는 경우 아무것도 변경되지 않았다는 사실, 그리고 다음에 무엇을 해야 하는지를 알려줍니다.
| 코드 | 상태 | 상황 | 조치 방법 |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | 30분이 지났습니다. 아무것도 등록되지 않았고 아무것도 변경되지 않았습니다. | nexusctl claim-code --administrator <email>로 새 코드를 만든 다음 I have a new code를 누르십시오. |
CLAIM_FINGERPRINT_MISMATCH |
403 | 전송된 핑거프린트가 이 설치 환경의 것이 아닙니다. | 중단하십시오. 주소와 인증서를 확인하십시오. |
TRANSITION_NOT_PERMITTED |
409 | 이미 완료된 단계가 다시 요청되었습니다(이미 소유권이 등록된 설치 환경에 대한 소유권 등록, 또는 두 번째로 시도된 첫 번째 관리자 생성). | 콘솔에서 로그인하십시오. 첫 번째 관리자가 다른 모든 사용자를 추가합니다. |
TRANSITION_NOT_PERMITTED |
409 | 대기 중인 첫 번째 관리자가 없는 브라우저에서, 또는 10분이 지난 후에 시도된 패스키 단계. | 아래를 참조하십시오. |
RATE_LIMITED |
429 | 1분 동안 첫 실행 페이지에서 너무 많은 시도가 있었습니다. 아무것도 전송되지 않았습니다. | 페이지에 표시된 시간(초)만큼 기다린 후 다시 시도하십시오. |
남은 시도 횟수가 없는 코드는 "This code has no tries left"라고 표시됩니다. 만료된 코드와 마찬가지로 새 코드를 만드십시오. 클러스터에 액세스할 수 있는 사람만 만들 수 있으며, 이것이 핵심입니다.
첫 실행 페이지들은 합쳐서 분당 20번의 시도를 허용합니다. 본인이 그러한 시도를 하지 않았다면 네트워크의 다른 누군가가 페이지를 시도하고 있는 것이며, 이는 알아둘 가치가 있습니다.
패스키 단계를 놓친 경우
첫 번째 관리자가 생성되었지만 10분 이내에 패스키가 만들어지지 않았거나 브라우저가 닫힌 경우, 관리자는 로그인할 방법 없이 존재하게 됩니다. 패스키 단계는 "If you made the first administrator in this browser over ten minutes ago, ask an operator: the administrator exists and has no passkey yet"이라는 문구와 함께 TRANSITION_NOT_PERMITTED을 응답합니다. 그 시점에는 소유권 등록이 이미 소진되었으므로 새 소유권 등록 코드는 도움이 되지 않습니다. 다른 시도를 하기 전에 설치를 실행한 운영자에게 문의하십시오.
브라우저가 소유권 등록 정보를 잃어버린 경우
소유권 등록 정보는 이를 생성한 브라우저의 페이지가 읽을 수 없는 쿠키에 존재합니다. 소유권 등록과 첫 번째 관리자 생성 사이에 브라우저가 이를 잃어버린 경우(예: 시크릿 창이 닫힌 경우), 첫 번째 관리자 양식에서는 수동으로 붙여넣은 소유권 등록 파일과 해당 설정 시크릿도 허용합니다.
Aoife가 패스키를 갖게 되자 Tomás는 터미널을 닫았습니다. 소유권 등록 페이지는 꺼졌고, 첫 번째 관리자가 존재하게 되었으며, 이제 들어가는 다른 모든 경로는 그녀를 통해 이루어졌습니다.






