팀 및 구성원

팀은 Braidrun의 협업 단위입니다. 여러 사람이 동일한 작업 흐름을 유지하고 자격 증명을 공유하며 서로 승인합니다. 이 페이지에서는 팀을 구성하고, 구성원을 초대하고, 리소스를 마이그레이션하는 방법을 설명합니다.

구조를 이해하기 위한 사진

• 계정은 다음에 속할 수 있습니다. 여러 팀; 현재 팀을 전환하려면 UI 오른쪽 상단에서 아래로 당깁니다.
• 각 팀에는 다음이 있습니다.
  • 워크플로 목록
  • 템플릿/모듈 라이브러리(본인이 홍보한 모듈은 팀과 공유됨)
  • 자격 증명 네임스페이스
  • 스케줄링/웹후크
  • 회원 목록 및 권한
  • 실행 내역 + 감사 로그
  • 알림 설정
  • 구독 및 할당량

팀 만들기

1. 왼쪽의 '팀' → 오른쪽 상단의 '새 팀'으로 이동하세요.
2. 이름(다른 멤버에게 표시됨), 슬러그(URL의 일부) 및 설명을 입력합니다.
3. 패키지 선택 - 현재 계정으로 구매한 패키지 중에서 선택하거나 "패키지 업그레이드"를 클릭하여 먼저 구매하세요.
4. 생성자는 자동으로 팀 소유자가 됩니다.

회원 초대(이메일 초대, 2026-04-27부터)

2026-04년부터 회원 초대는 전적으로 UUID 붙여넣기 대신 이메일을 통해 이루어집니다.

1. 팀 세부정보 페이지 → 구성원 탭 → "초대장 보내기"
2. 상대방의 이메일 주소 입력(한 번에 하나씩, 멱등성: 동일한 이메일 주소로 다시 전송하면 PENDING 초대 기록이 재사용됨) + 사전 할당된 역할 선택
3. 시스템은 32바이트 무작위 토큰(256비트 엔트로피, 열거 불가능)에 대한 링크가 포함된 이메일을 보냅니다.
4. 상대방이 링크를 클릭 → /teams/invitations/accept redemption 페이지로 이동
5. 상대방이 로그인되어 있지 않으면 자동으로 로그인 페이지로 이동합니다. 로그인 후 교환 페이지로 돌아갑니다.
6. 교환 중 시스템 확인: 현재 로그인한 사용자의 이메일 주소는 초대 이메일 주소와 일치해야 합니다(대소문자 구분 안 함). 전달된 링크는 다른 사람이 사용할 수 없습니다.

API를 사용하여 초대장 만들기

curl -X POST 'https://braidrun.com/api/teams/{teamId}/invitations' \
  -H 'Authorization: Bearer dyk_...' \
  -H 'Content-Type: application/json' \
  -d '{"email": "newmember@example.com"}'

반대편에서 교환:

curl -X POST 'https://braidrun.com/api/teams/invitations/accept' \
  -H 'Authorization: Bearer dyk_...' \
  -H 'Content-Type: application/json' \
  -d '{"token": "<32-byte-token-from-email>"}'

역할 할당

높은 것부터 낮은 것까지 4가지 역할: 소유자/관리자/편집자/뷰어. 각 역할이 구체적으로 무엇을 할 수 있는지 알아보세요. 권한 및 역할.

회원관리

회원 목록에서 관리자 이상은 다음을 수행할 수 있습니다.

• 회원 역할 수정(다운그레이드/승격)
• Remove a member (all related operation history of the other party is retained, but the permissions become invalid)
• 각 회원의 마지막 활동 시간 보기
• 각 구성원이 보유한 자격 증명 수와 생성된 워크플로 수를 확인하세요.

소유권 이전

팀에는 소유자가 한 명만 있을 수 있습니다. 소유권을 다른 사람에게 이전하고 싶으신가요?

1. 팀 설정 → "소유권 이전".
2. 현재 관리자를 새 소유자로 선택합니다.
3. 2단계 인증 - 현재 소유자가 이메일이나 TOTP를 통해 두 번 확인해야 합니다.
4. 완료 후 현재 소유자는 자동으로 관리자로 다운그레이드됩니다. 구독 청구서 소유권도 이전됩니다.

현재 팀 전환

오른쪽 상단에 있는 사용자 아바타를 아래로 끌어내리고 → "현재 팀"을 선택합니다. 전환 후:

• 모든 사이드바 목록(워크플로/자격 증명/스케줄링/실행/승인)이 새 팀의 데이터로 다시 로드됩니다.
• URL에는 새로 고침 후에도 유지되는 팀 매개변수가 포함됩니다.
• 전환하면 열려 있는 워크플로 편집기가 닫힙니다(팀 간 실수로 인한 변경을 방지하기 위해).

팀 간 리소스 이동

워크플로가 다른 팀으로 이동됨

1. 워크플로 세부정보 페이지 → 설정 → "팀으로 이동".
2. 대상 팀을 선택하세요. 대상 팀의 편집자 이상이어야 합니다.
3. 시스템은 워크플로에서 참조된 자격 증명이 동일한 이름을 가진 대상 팀에도 존재하는지 확인합니다. 존재하지 않는 경우 목록에 표시되며 "동일한 이름으로 자격 증명 건너뛰기/생성/이동 취소"를 선택할 수 있습니다.
4. 확인 후 워크플로 + 기록 실행이 함께 새 팀으로 마이그레이션됩니다.

자격 증명의 팀 간 복제

자격 증명은 "이동"할 수 없으며 "복사"만 가능합니다. 실수로 원래 팀의 권한을 취소하는 것을 방지하기 위한 것입니다. 값을 다시 입력한 다음 대상 팀에 동일한 이름의 자격 증명을 생성하라는 메시지가 표시됩니다.

팀감사

"팀 설정 → 감사 로그"는 모든 변경 사항을 기록합니다.

• 누가/언제/어떤 작업 흐름/어떤 필드가 변경되었는지
• 누가/언제/생성/삭제/업데이트한 자격 증명
• 누가/언제/어떤 승인을 시작/승인했는지
• 회원 가입/탈퇴/역할 변경

감사 로그는 365일(팀)/영구(기업) 동안 보관되며 CSV 내보내기를 지원합니다.

팀을 해산하다

소유자는 해산될 수 있습니다. 해산하기 전에 시스템에서 다음을 수행할 수 있습니다.

1. 모든 워크플로 내보내기(YAML의 ZIP)
2. 모든 실행 기록 내보내기(CSV 또는 JSON)
3. 모든 회원에게 알림(자동으로 이메일 보내기)
4. 2단계 확인

해산 후 30일 이내에 복원이 가능합니다. 30일 후에는 데이터가 완전히 지워져 검색할 수 없습니다.

다음 단계

• 권한 및 역할 — 네 가지 역할이 수행할 수 있는 작업에 대한 자세한 비교표
• 구독 및 가격 — 팀/기업 할당량 차이
• 자격 증명 — 팀 공유 자격 증명의 의미