Okta 워크플로용 Miro 커넥터를 사용하면 Miro에서 반복적이고 여러 단계로 이루어진 관리자 작업을 손쉽게 자동화할 수 있습니다. 워크플로 자동화 설정 방법을 알아보고 팀과 사용자 관리를 간소화하세요.
해당 대상: Enterprise 플랜
Miro 사용자 관리 커넥터
Miro 사용자 관리 커넥터는 SCIM이 활성화된 Miro Enterprise 고객이 조직에 사용자를 추가하고 사용자의 라이선스와 상태를 관리할 수 있도록 합니다.
Miro 사용자 관리 커넥터 권한 부여:
Miro 사용자 관리 카드를 워크플로에 처음 추가하면 조직용 연결을 설정하라는 프롬프트가 표시됩니다. 자세한 내용은 권한 부여.
Miro 사용자 관리 커넥터의 액션 카드:
| 동작 | 설명 |
| 사용자 만들기 | 새 사용자를 생성합니다. |
| 사용자 조회 | 조직에서 이메일 주소로 기존 사용자를 검색합니다. |
| 사용자 라이선스 유형을 Full로 업그레이드 | 기존 사용자 리소스를 업데이트해 사용자 라이선스 유형을 Full로 변경합니다. |
| 사용자 상태 업데이트 | 기존 사용자 리소스를 업데이트해 활성 상태를 true 또는 false로 변경합니다.Miro 사용자 관리 커넥터는 SCIM 토큰을 사용해 작동합니다. Miro 사용자 관리는 SSO(통합로그인)와 SCIM이 활성화된 엔터프라이즈에서만 사용할 수 있습니다. |
인증
연결 페이지에서 여러 연결을 생성하고 관리할 수 있습니다.
여러 조직을 운영할 계획이라면 유용합니다. Miro 사용자 관리 커넥터의 각 연결은 하나의 Miro 조직만 가리킬 수 있습니다.
SCIM을 활성화하고 새 토큰을 발급받거나 기존 토큰을 복사하려면 SCIM을 활성화하는 방법 문서의 지침을 따르세요.
액션 카드에서 새 연결을 생성하려면:
- 새 연결을 클릭하세요.
- 연결 닉네임을 입력하세요. 조직을 나타내는 이름을 권장합니다.
-
Miro의 Enterprise 통합 페이지에서 SCIM 프로비저닝을 활성화하려면 설정 방법을 따르세요.
- Miro에서 Base URL을 복사해 연결의 Base URL 필드에 붙여넣으세요
- Miro에서 Api Token을 복사해 연결의 Access Token 필드에 붙여넣으세요
- Create를 클릭하세요. 이렇게 하면 연결이 저장되고 워크플로로 돌아갑니다.
사용자 만들기
조직 내에서 사용자를 생성합니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 사용자 세부 정보 | |||
| 이메일 주소 | 사용자의 이메일 주소. | 문자열 | 예 |
| 활성 상태 |
사용자의 상태.
지정하지 않으면 기본값은 false. |
드롭다운 | FALSE |
| 사용자 라이선스 유형 |
사용자의 라이선스 유형입니다.
지정하지 않으면 조직의 플랜에 따라 Miro의 내부 로직으로 사용자 라이선스가 설정됩니다. |
드롭다운 | FALSE |
| 역할 |
조직 내 사용자의 역할입니다.
지정하지 않으면 기본값은 조직 구성원입니다. |
드롭다운 | 거짓 |
| 이름 | |||
| 성 | 사용자의 성(성씨) | 문자열 | FALSE |
| 이름 | 사용자의 이름 | 문자열 | FALSE |
| 표시 이름 | Miro에 표시될 이름 | 문자열 | FALSE |
출력
| 필드 | 정의 | 유형 |
| 사용자 | ||
| 사용자 ID | 새 사용자의 ID입니다. | 문자열 |
사용자 조회
이메일로 조직 내 기존 사용자를 검색합니다
입력
| 필드 | 정의 | 유형 | 필수 |
| 쿼리 | |||
| 이메일 주소 | 검색할 사용자의 이메일 주소 | 문자열 | 예 |
출력
| 필드 | 정의 | 형식 |
| 사용자 | ||
| 사용자 ID | 사용자의 ID. | 숫자 |
| 사용자 라이선스 유형 | 사용자의 라이선스 유형. | 숫자 |
| 활성 |
사용자의 상태.
|
숫자 |
| 이름 | ||
| 사용자 이름 | 사용자의 이메일 주소. | 숫자 |
| 성 | 사용자의 성 또는 성씨. | 숫자 |
| 이름 | 사용자의 이름. | 숫자 |
| 표시 이름 | Miro에 표시되는 이름입니다. | 숫자 |
사용자 라이선스 유형을 Full으로 업그레이드
기존 사용자 리소스를 업데이트해 사용자 유형(라이선스)을 Full로 변경합니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 사용자 | |||
| 사용자 ID | 사용자의 ID. | 문자열 | TRUE |
출력
| 필드 | 정의 | 유형 |
| 응답 | ||
| 상태 코드 |
요청의 HTTP 상태.
라이선스 업데이트 실패를 나타내는 코드:
|
숫자 |
사용자 상태 업데이트
존재하는 사용자 리소스를 업데이트해 활성 상태를 true 또는 false 값으로 변경합니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 사용자 | |||
| 사용자 ID | 사용자의 ID입니다. | 문자열 | 예 |
| 활성 |
사용자의 새 상태.
|
드롭다운 | TRUE |
출력
| 필드 | 정의 | 타입 |
| 응답 | ||
| 상태 코드 |
요청의 HTTP 상태.
활성 상태 업데이트가 실패했음을 나타내는 코드:
|
번호 |
Miro 관리 커넥터
Miro 관리 커넥터는 엔터프라이즈 고객이 팀을 생성하고 팀 설정 및 팀 구성원을 관리할 수 있도록 합니다.
Miro 관리 커넥터 승인:
Miro 카드를 워크플로에 처음 추가하면 조직용 연결을 설정하라는 프롬프트가 표시됩니다. 자세한 내용은 권한 부여.
Miro Administration Connector 동작 카드:
| 동작 | 설명 |
| 팀 만들기 | 기존 조직에 새 팀을 만듭니다. |
| 팀 검색 | 조직에서 기존 팀을 검색합니다. 결과 집합에서 일치하는 처음 10개 레코드가 선택됩니다.. |
| 팀에 구성원 추가 | 기존 팀에 새 구성원을 추가합니다. |
| 팀 멤버 역할 업데이트 | 기존 팀의 구성원 역할을 업데이트합니다. |
| 팀 설정 가져오기 | 기존 팀의 설정을 가져옵니다. |
| 팀 공유 정책 설정 업데이트 | 기존 팀의 공유 정책 설정을 업데이트합니다. |
| 팀 초대 설정 업데이트 | 기존 팀의 초대 정책 설정을 업데이트합니다. |
| 팀 협업 설정 업데이트 | 기존 팀의 협업 정책 설정을 업데이트합니다. |
| 팀 공개 설정 업데이트 | 기존 팀의 공개 정책 설정을 업데이트합니다. |
| 팀 복사 접근 설정 업데이트 | 기존 팀의 복사 접근 정책 설정을 업데이트합니다. |
| 사용자 세션 초기화 (베타) | 지정된 이메일 주소의 모든 사용자 세션을 삭제합니다. |
인증
Miro Administration 커넥터는 OAuth API 토큰을 사용해 작동합니다. Miro Administration 커넥터는 Enterprise 플랜 고객만 이용할 수 있습니다. 새 연결을 생성하려면 아래에 나열된 권한(스코프)을 포함해 앱을 설치할 수 있는 권한이 필요합니다.
여러 연결을 생성하고 관리할 수 있습니다. 연결 페이지에서.
여러 조직을 운영할 계획이라면 유용합니다. Miro Administration 커넥터의 각 연결은 하나의 Miro 조직만 가리킬 수 있습니다.
액션 카드에서 새 연결을 생성하려면:
- 새 연결을 클릭하세요.
- 연결 별칭을 입력하세요. 조직을 대표하는 이름을 권장합니다.
- Miro의 Enterprise 통합 페이지에서 조직 ID 와 액세스 토큰을 가져오려면 지침을 따르세요.
- 다음으로 Create를 클릭합니다. 연결이 저장되고 워크플로로 돌아갑니다.
지원되는 스코프:
- organizations:teams:write
- organizations:teams:read
팀 만들기
기존 조직에 팀을 만듭니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 팀 | |||
| 팀 이름 | 팀의 이름. | 문자열 | TRUE |
출력
| 필드 | 정의 | 형식 |
| 응답 | ||
| 팀 ID | 새 팀의 ID입니다. | 문자열 |
팀 검색
조직의 기존 팀을 검색합니다. 결과 집합에서 일치하는 첫 10개 레코드를 선택합니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 쿼리 | |||
| 팀 이름 | 팀 이름과 일치하는 단어입니다. 이름에 해당 단어가 포함된 모든 팀이 결과 집합으로 반환됩니다. 쿼리와 정확히 일치하는 이름의 팀은 결과 상단에 표시됩니다. | 문자열 | FALSE |
출력
| 필드 | 정의 | 유형 |
| 응답 | ||
| 팀 목록 | 처음 검색된 10개 팀의 목록입니다. 각 팀에는 아래 필드가 포함됩니다. | 목록 |
| 팀 ID | 팀의 ID | 문자열 |
| 이름 | 팀 이름 | String |
팀에 구성원 추가
기존 팀에 새 구성원을 추가합니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 팀 | |||
| 팀 ID | 팀의 ID입니다. | 문자열 | TRUE |
| 멤버 | |||
| 사용자 이메일 | 팀에 추가하려는 사용자의 이메일 주소. | 문자열 | TRUE |
출력
| 필드 | 정의 | 유형 |
| 응답 | ||
| 멤버 ID | 새 팀 멤버의 ID. | 문자열 |
팀 멤버 역할 업데이트
기존 팀에서 팀 멤버의 역할을 업데이트합니다.
입력
| 필드 | 정의 | 형식 | 필수 |
| 팀 | |||
| 팀 ID | 팀의 ID. | 문자열 | TRUE |
| 구성원 | |||
| 팀 구성원 ID | 팀 구성원의 ID입니다. | String | TRUE |
| 역할 |
팀 내 멤버의 새로운 역할.
|
드롭다운 | TRUE |
출력
| 필드 | 정의 | 유형 |
| 응답 | ||
| 멤버 ID | 팀 멤버의 ID. | 문자열 |
| 역할 |
팀 멤버에게 할당되는 새 역할입니다.
|
문자열 |
팀 설정 가져오기
기존 팀의 설정을 가져옵니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 팀 | |||
| 팀 ID | 팀의 ID입니다. | 문자열 | 예 |
출력
| 필드 | 정의 | 유형 |
| 팀 초대 설정 | ||
| 초대할 수 있는 사용자 |
|
문자열 |
| 외부 사용자 초대 |
|
문자열 |
| 팀 협업 설정 | ||
| 공동 소유자 역할 |
|
문자열 |
| 팀 복사 액세스 수준 설정 | ||
| 복사 액세스 수준 |
|
문자열 |
| 복사 액세스 수준 제한 |
|
문자열 |
| 팀 검색 설정 | ||
| 검색 |
|
문자열 |
| 팀 공유 정책 설정 | ||
| 기본 보드 액세스 |
|
문자열 |
| 기본 조직 액세스 |
|
문자열 |
|
조직 수준에서의 공유
|
|
문자열 |
| 팀에서의 공유 |
|
문자열 |
| 공개 링크를 통한 공유 |
|
문자열 |
| 보드를 팀으로 이동 |
|
문자열 |
팀 공유 정책 설정 업데이트
기존 팀의 공유 정책 설정을 업데이트합니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 팀 | |||
| 팀 ID | 팀의 ID입니다. | 문자열 | TRUE |
| 기본 보드 접근 권한 |
|
드롭다운 | 거짓 |
| 기본 조직 액세스 |
|
드롭다운 | 아니요 |
| 공개 링크를 통한 공유 |
|
드롭다운 | 거짓 |
| 팀 공유 |
|
드롭다운 | FALSE |
|
조직에서의 공유
|
|
드롭다운 | 거짓 |
| 보드를 팀으로 이동 |
|
드롭다운 | 거짓 |
출력
| 필드 | 정의 | 유형 |
| 팀 공유 정책 설정 | ||
| 기본 보드 액세스 |
|
문자열 |
| 조직 기본 접근 권한 |
|
문자열 |
|
조직에서의 공유
|
|
문자열 |
| 팀에서 공유 |
|
문자열 |
| 공개 링크를 통해 공유 |
|
문자열 |
| 보드를 팀으로 이동 |
|
문자열 |
팀 초대 설정 업데이트
기존 팀의 초대 정책 설정을 업데이트합니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 팀 | |||
| 팀 ID | 팀의 ID입니다. | 문자열 | 예 |
| 외부 사용자 초대 |
|
드롭다운 | FALSE |
| 초대할 수 있는 사용자 |
|
드롭다운 | 거짓 |
출력
| 필드 | 정의 | 유형 |
| 팀 초대 설정 | ||
| 외부 사용자 초대 |
|
문자열 |
| 초대할 수 있는 사용자 |
|
문자열 |
팀 복사 권한 설정 업데이트
기존 팀의 복사 권한 정책 설정을 업데이트합니다.
입력
| 필드 | 정의 | 형식 | 필수 |
| 팀 | |||
| 팀 ID | 팀의 ID | 문자열 | TRUE |
| 복사 권한 수준 |
|
드롭다운 | FALSE |
| 복사 권한 수준 제한 |
|
드롭다운 | FALSE |
출력
| 필드 | 정의 | 유형 |
| 팀의 복사 권한 설정 | ||
| 복사 액세스 수준 |
|
문자열 |
| 복사 액세스 수준 제한 |
|
문자열 |
팀 협업 설정 업데이트
기존 팀의 협업 정책 설정을 업데이트합니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 팀 | |||
| 팀 ID | 팀 ID | 문자열 | TRUE |
| 공동 소유자 역할 |
|
드롭다운 | FALSE |
출력
| 필드 | 정의 | 유형 |
| 팀 협업 설정 | ||
| 공동 소유자 역할 |
|
문자열 |
팀 공개 설정 업데이트
기존 팀의 검색 정책 설정을 업데이트합니다.
입력
| 필드 | 정의 | 형식 | 필수 |
| 팀 | |||
| 팀 ID | 팀의 ID. | 문자열 | 예 |
| 검색 |
|
드롭다운 | 거짓 |
출력
| 필드 | 정의 | 유형 |
| 팀 검색 설정 | ||
| 팀 검색 |
|
문자열 |
사용자 세션 일괄 삭제
지정된 이메일 주소의 모든 사용자 세션을 삭제합니다.
입력
| 필드 | 정의 | 유형 | 필수 |
| 사용자 세부 정보 | |||
| 이메일 주소 | 세션을 삭제할 사용자의 이메일 주소. | 문자열 | 예 |
출력
| 필드 | 정의 | 유형 |
| 응답 | ||
| 상태 코드 |
요청의 HTTP 상태.
사용자 세션 삭제 업데이트가 실패했음을 나타내는 코드:
|
번호 |