계정을 승인하고, 역할로 쓸 수 있는 범위를 정합니다

계정 신청 승인

첫 페이지의 「계정 신청」으로 들어온 신청은 사용자 관리 위쪽의 「계정 신청」 카드에 모입니다. 대기 건수는 메뉴와 운영 현황의 「처리할 일」에도 표시됩니다.

• 카드에서 이름 · 이메일 · 소속 · 부서 · 신청 시각 · 사유를 확인합니다.
• 승인하면 계정이 활성화되고 외부 계정(external) 그룹으로 옮겨지며, 신청자에게 안내 메일이 발송됩니다. 신청자가 메일의 링크에서 비밀번호를 설정하면 로그인할 수 있습니다(링크를 여는 것이 이메일 확인입니다). 링크는 7일 안에 완료해야 하며, 지나면 신청이 만료되어 다시 신청해야 합니다.
• 거절하면 신청 계정이 삭제됩니다. 신청자에게 따로 알림이 가지는 않습니다.
• 승인한 뒤에는 아래 사용자 목록에서 조직과 역할을 지정합니다. 외부 계정은 기본으로 최소 권한만 가집니다.
• 외부 계정에게는 개인 설정의 「외부 연결」(네이버웍스·Google 연결) 메뉴가 보이지 않습니다. 회사 구성원(pylon-staff) 전용입니다.
• 회사 구성원이 외부인을 먼저 초청하면(초청 기능을 켠 환경) 신청 절차 없이 같은 안내 메일이 나가고, 이미 신청 중인 사람을 초청하면 그 신청이 승인된 것으로 처리됩니다.

외부 사용자 초청

사용자 관리 → 사용자 추가에서 외부 사용자 초청 탭을 고르면, 외부 사람이 신청하지 않아도 먼저 초청할 수 있습니다.

• 이메일 · 이름 · 소속을 입력하고 초청 사유를 적습니다(부서는 선택).
• 보내면 입력한 이메일로 비밀번호 설정 링크가 담긴 안내 메일이 발송됩니다. 링크는 7일 안에 열어야 합니다.
• 외부 계정은 최소 권한으로 만들어지며, 조직과 역할은 승인 신청과 마찬가지로 이후에 지정합니다.
• 이미 계정 신청 중인 이메일이면 그 신청이 승인된 것으로 처리됩니다. 회사 이메일과 이미 있는 이메일은 초청할 수 없습니다.

사용자 관리

• 계정을 직접 만들고, 비밀번호를 초기화하고, 삭제합니다.
• 사용자 한 명을 열어 조직(한 명당 하나)과 역할(여러 개 가능)을 지정합니다.

역할(Role)과 허용 목록

권한은 역할에 붙습니다. Role 관리에서 역할마다 다음을 정합니다.

• 쓸 수 있는 모델 · 플러그인 · 공유 스킬 · 에이전트 · MCP 서버
• 작업할 수 있는 경로
• 고를 수 있는 Preset 과 기본 Preset(우선순위 포함) — 새로 추가한 역할은 허용 Preset 이 없는 채로 시작하니, 쓸 Preset 을 골라 주세요
• 관리자 권한 여부
• 서비스 계정 여부 — 사람이 아니라 다른 시스템이 쓰는 계정으로, 서비스 계정에 맞는 기본 제약이 적용됩니다

역할 목록은 사용자 · 관리자 · 서비스 Role 탭으로 나뉩니다. 서비스 계정용 기본 역할 pylon-service 는 처음부터 만들어져 있습니다.

「Users」 탭에서 사용자나 조직 단위로 역할에 넣고 뺍니다. 모든 사용자에게 공통으로 적용되는 기본 역할도 있습니다.

잠시 쓰지 않을 역할은 지우지 말고 **「사용 안 함」**으로 끌 수 있습니다. 끈 역할은 권한에 반영되지 않고 목록에서도 숨겨지며, 「사용 안 함 포함」을 켜면 끈 시각과 함께 볼 수 있습니다. 설정은 그대로 남아 「다시 사용」을 누르면 그대로 적용됩니다. 허용 목록을 정하지 않은 역할(Keycloak 기본 역할 등)도 끌 수 있으며, 이때는 권한에 변화 없이 목록에서만 숨겨집니다. 기본 관리자 역할(pylon-admin, pylon-master-admin)은 끌 수 없습니다.

사용자 한 명에게만 예외를 주려면 사용자 접근에서 그 사람의 허용 범위를 따로 정합니다.

권한을 바꾼 뒤에는 해당 사용자가 다시 로그인해야 반영됩니다.

조직

조직 관리는 조직도입니다. 조직을 만들고 사용자를 넣고 뺍니다. 조직은 권한을 주지 않으며, 권한은 역할로만 정해집니다. Role 관리에서 조직 단위로 사용자를 역할에 넣을 때 편리하게 쓰입니다.

관리자 지정

관리자는 pylon-admin(또는 pylon-master-admin) 역할을 주거나, 역할 · 사용자 접근에서 관리자 권한을 켜서 지정합니다.