이 기능은 콘솔에 로그인한 상태에서만 됩니다. API 키로 부르면 거절됩니다.
역할과 업무 권한
구성원마다 도입사 역할과 업무 권한이 있습니다.- 조회 (read)는 고객, 사용량과 청구 내역을 봅니다. 수집 (ingest)은 고객 등록과 사용량 이벤트 전송을 합니다. 전체 관리 (admin)는 조회와 수집을 포함하고 그 밖의 데이터 변경도 합니다. 권한별로 허용되는 요청은 화면과 API, 권한을 보세요.
- 역할은 업무 권한을 따라갑니다. 일반 사용자에게 전체 관리 (admin)를 주면 관리자가 되고, 관리자의 권한에서 전체 관리 (admin)를 빼면 일반 사용자가 됩니다.
- 조회 (read) 권한이 없는 구성원은 콘솔에서 업무 화면을 볼 수 없고 ‘업무 조회 권한이 없습니다’ 안내를 봅니다.
- 도입사 계정과 권한은 업무 환경에 관계없이 같습니다. 테스트 환경에서 준 권한이 실제 환경에도 그대로 적용됩니다. 환경마다 따로인 것은 업무 환경을 보세요.
- 구성원의 권한과 API 키의 권한은 따로 관리합니다. 구성원 권한을 바꿔도 그 사람이 발급한 API 키의 권한은 바뀌지 않습니다.
구성원 추가하기
구성원은 초대 링크로 추가하거나 계정을 직접 만들어 추가합니다. 두 방법 모두 ‘사용자 관리’ 화면의 ‘함께 일할 사용자 추가’에 있습니다.
이미 MeterEngine 계정이 있는 이메일은 계정 직접 생성을 쓸 수 없습니다(
409 email_already_exists). 그 사람은 초대 링크로 추가하세요.
초대 링크로 추가하기
MeterEngine은 초대 메일을 보내지 않습니다. 대표관리자가 링크를 복사해 초대할 사람에게 직접 전달합니다.1
초대 링크를 발급한다
‘사용자 관리’ 화면의 ‘초대 링크 만들기’에서 ‘초대할 이메일’과 ‘업무 권한’을 정하고 ‘초대 링크 발급’을 누릅니다.
2
링크를 복사한다
발급하면 ‘초대 링크 열기’와 ‘초대 링크 복사’가 한 번만 나옵니다. 닫기 전에 ‘초대 링크 복사’를 눌러 복사하세요. 닫으면 링크를 다시 볼 수 없고, ‘초대 이력’ 목록에도 링크는 나오지 않습니다. 링크는
https://meterengine.com/organization-invitations/me_invite_ 로 시작합니다.3
초대할 사람에게 직접 전달한다
메신저 등으로 초대할 사람에게만 보내세요. 링크는 발급 뒤 48시간 동안 지정한 이메일로 한 번만 수락할 수 있습니다.
409 organization_member_already_exists).
초대받은 사람이 하는 일
초대받은 사람은 링크를 열면 ‘(도입사 이름)에 참여’ 화면에서 참여 권한과 수락 기한(KST)을 봅니다. 그다음은 계정이 있는지에 따라 다릅니다.- MeterEngine 계정이 없을 때
- 이미 계정이 있을 때
1
계정 정보를 넣는다
‘이름’, ‘비밀번호’를 넣습니다. 비밀번호는 8자 이상 72자 이하이고 한글은 1자를 3자로 계산합니다. 이메일은 초대받은 이메일로 정해져 있습니다.
2
필수 동의에 체크한다
‘이용 안내’와 ‘개인정보 처리 안내’에 모두 체크합니다. 동의 내용은 가입과 승인의 필수 동의와 같습니다.
3
수락한다
‘초대 수락하고 도입사로 이동’을 누르면 계정이 만들어지고 로그인된 채로 그 도입사의 ‘개요’ 화면으로 이동합니다.
계정을 직접 만들어 추가하기
1
계정을 만든다
‘사용자 관리’ 화면의 ‘계정 직접 생성’에서 ‘사용자 이메일’, ‘이름’, ‘초기 비밀번호’, ‘업무 권한’을 넣고 ‘사용자 계정 생성’을 누릅니다. 초기 비밀번호는 8자 이상 72자 이하이고 한글은 1자를 3자로 계산합니다.
2
로그인 정보를 전달한다
이메일과 초기 비밀번호를 본인에게 안전하게 전달합니다. MeterEngine은 메일을 보내지 않습니다.
3
본인이 첫 로그인을 마친다
본인이 처음 로그인하면 ‘계정 이용 안내 확인’ 화면이 나옵니다. ‘새 비밀번호’와 ‘새 비밀번호 확인’에 초기 비밀번호와 다른 비밀번호를 넣고 ‘이용 안내’와 ‘개인정보 처리 안내’에 체크한 뒤 ‘동의하고 업무 시작’을 누르면 업무를 시작할 수 있습니다. 이때부터 초기 비밀번호는 쓸 수 없고, 다른 곳에서 연 이 계정의 로그인도 끝납니다.
403 consent_required로 거절됩니다.
초대 이력
대표관리자는 ‘사용자 관리’ 화면의 ‘초대 이력’에서 발급한 초대를 봅니다.
만료, 수락 완료, 초대 취소 상태의 초대는 다시 쓸 수 없습니다. 다시 초대하려면 새로 발급합니다.
권한과 역할 바꾸기
대표관리자는 ‘도입사 사용자’ 목록에서 사용 중인 구성원마다 아래 동작을 할 수 있습니다. 바꾼 권한은 그 구성원이 이미 로그인해 있어도 다음 요청부터 적용됩니다.- 구성원을 대표관리자로 만들려면 먼저 초대나 계정 생성으로 추가한 뒤 ‘역할 변경’으로 바꿉니다. 초대 링크로 바로 대표관리자를 만들 수는 없습니다.
- 대표관리자를 일반 사용자로 바꾸려면 ‘역할 변경’으로 관리자로 바꾼 뒤 ‘권한 변경’으로 전체 관리 (admin)를 뺍니다.
- 대표관리자의 업무 권한에서는 전체 관리 (admin)를 뺄 수 없습니다(
409 owner_scopes_required).
소속 보관
소속을 보관하면 그 구성원은 이 도입사에 더 접근할 수 없고, 이 도입사를 열어 둔 그 사람의 로그인은 바로 끝납니다. 그 사람이 남긴 업무와 감사 기록은 그대로 남고, 그 이메일로 발급해 둔 초대 대기 상태의 초대도 함께 취소됩니다. API 키는 사람이 아니라 도입사에 속하므로 그 사람이 발급한 키는 소속을 보관해도 계속 쓸 수 있습니다. 그 사람이 키 원문을 알고 있다면 키 교체, 권한 변경, 폐기를 보고 교체하거나 폐기하세요. 보관한 구성원을 다시 들이려면 같은 이메일로 초대 링크를 새로 발급해 수락받습니다. 이때 권한은 새 초대에 정한 권한이 됩니다. 보관된 소속은 ‘도입사 사용자’ 목록 위의 ‘사용 중’, ‘보관됨’, ‘전체’ 가운데 ‘보관됨’을 골라 봅니다.여러 도입사에 속할 때
한 계정은 초대를 받아 여러 도입사에 속할 수 있습니다.- 로그인하면 소속된 도입사 가운데 가장 먼저 소속된 사용 중인 도입사로 들어갑니다.
- 다른 도입사로 옮기려면 콘솔 위의 도입사 이름을 눌러 ‘도입사 선택’ 화면으로 갑니다. ‘접근할 도입사’에서 도입사를 고르고 ‘도입사로 이동’을 누릅니다.
- 역할과 업무 권한은 도입사마다 따로입니다. 한 도입사에서 대표관리자여도 다른 도입사에서는 일반 사용자일 수 있습니다.
- 사용 중이 아닌 도입사(승인 대기, 가입 거절, 이용 정지)로는 업무를 할 수 없습니다. 상태의 뜻은 가입과 승인을 보세요.
오류
오류 응답의 형식과 처리 방법은 오류 응답과 X-Request-ID를 보세요.