Azure Cards는 사용자가 Azure Boards의 작업 항목을 Miro 보드로 가져오고 동기화할 수 있게 해줍니다. 이 가이드는 통합의 기술적 구현, 보안 모델, 데이터 처리 방식, 그리고 통합을 평가하거나 구성하는 관리자를 위한 Microsoft 동의 흐름을 다룹니다. 전체 기능 안내와 최종 사용자 설정 단계는 Azure Cards를 참조하세요.
요구 사항 및 제한
- 카드에서 어떤 속성을 표시할지 선택하는 카드 사용자화는 지원되지 않습니다.
- 클립보드에서 작업 URL을 붙여넣어 카드를 가져오는 기능은 지원되지 않습니다.
기술적 구현
Miro는 Azure DevOps REST API를 통해 Azure Boards와 통합되며, Azure DevOps 서비스 훅을 구독해 작업 항목 업데이트를 실시간으로 수신합니다.
데이터 흐름
데이터는 Azure DevOps와 Miro 간에 양방향으로 흐릅니다.
Azure DevOps → Miro:
- Azure DevOps 작업 항목 선택기에 표시되는 작업 항목 목록입니다. 이 목록에는 요청한 사용자가 Azure DevOps에서 접근할 수 있는 작업 항목만 포함되며, ID, 유형, 제목, 담당자, 상태를 포함합니다.
- Azure 카드에 표시되는 작업 항목 세부정보: ID, 제목, 프로젝트, 유형, 상태, 설명, 상위 작업 항목, 담당자, 우선순위, 영역, 이터레이션, 스토리 포인트, 그리고 Azure Boards 작업 항목 URL. 이 정보는 Azure Boards의 해당 항목이 업데이트될 때마다 전송됩니다. Azure DevOps는 이 항목들과 함께 다른 작업 항목 필드도 전송하지만, Miro는 이 목록에 포함되지 않은 항목은 모두 폐기합니다.
Miro → Azure DevOps:
- Azure 카드 생성에 사용되는 작업 항목 정보: 제목, 프로젝트, 유형, 상태, 설명, 상위 작업 항목, 담당자, 우선순위, 영역, 반복, 스토리 포인트.
- 카드 생성 시 선택기 결과와 담당자, 영역, 반복, 상위 작업 항목을 필터링하는 데 사용되는 검색 문자열.
전송 중 데이터
Azure DevOps와 Miro 간에 교환되는 데이터는 TLS로 암호화됩니다.
데이터 보유
Miro는 카드가 보드에 있는 동안 보드에 추가된 작업 항목 데이터를 보유하며, 서비스 후크가 구성된 경우 해당 데이터를 계속 업데이트합니다. 이 데이터에 대한 고정된 보유 기간은 없으며, 표준 Miro 계정 보안 프로토콜이 적용됩니다.
인증 및 권한 부여
사용자는 OAuth 2.0 권한 부여 코드 그랜트를 사용해 Azure 계정을 인증하고 권한 부여 코드를 액세스 토큰으로 교환합니다. Azure DevOps OAuth 작동 방식에 대한 자세한 내용은 Microsoft의 OAuth 문서를 참조하세요.
Azure Cards에 권한을 부여한 각 Miro 사용자에게는 별도의 액세스 토큰이 발급되며 — 토큰은 사용자 간에 공유되지 않습니다.
필수 권한 범위
-
vso.identity— 식별자 및 그룹 읽기 -
vso.graph— 사용자, 그룹, 범위 및 그룹 멤버십 정보 읽기 -
vso.memberentitlementmanagement— 사용자, 라이선스 및 해당 사용자가 액세스할 수 있는 프로젝트와 확장 기능 읽기 -
vso.project— 프로젝트 및 팀 읽기 -
vso.work_full— 작업 항목, 쿼리, 백로그, 플랜 및 작업 항목 추적 메타데이터에 대한 전체 액세스. 서비스 훅을 통해 작업 항목 이벤트 알림을 수신하는 데에도 필요합니다. 이 범위는 Miro가 실제로 사용하는 권한보다 더 넓습니다 — Azure DevOps는 작업 항목에만 제한된 더 좁은 범위를 제공하지 않으며, Miro는 작업 항목 데이터만 읽고 씁니다.
자세한 내용은 Microsoft의 권한 범위 문서를 확인하세요.
Miro에 저장되는 항목 및 저장 방식
통합 작동 중에는 액세스 토큰만 사용됩니다 — Miro는 액세스 토큰을 제외한 요청 토큰이나 기타 OAuth 비밀값을 보관하지 않습니다. 액세스 토큰은 Miro의 데이터베이스에 안전하게 저장되며 서버 측에서만 사용됩니다.
서비스 후크 보안
Miro는 통합을 설정하는 각 팀에 대해 비밀 키가 포함된 고유한 서비스 후크 URL을 생성합니다. 각 Azure DevOps 인스턴스는 작업 항목 변경 사항을 Miro에 알리기 위해 자체 고유한 서비스 후크 URL을 호출합니다.
요청은 암호화된 연결을 통해 전송되므로 URL 자체는 전송 중에 노출되지 않습니다. 서비스 후크 URL이 무단 제3자에게 도달할 수 있는 주된 경로는 Azure DevOps 관리자가 의도적이든 실수로든 조직 외부에 키를 공유하는 경우입니다.
연결 또는 재연결 시 동의 시나리오
Azure DevOps 인스턴스를 연결하거나 재연결하면, 예를 들어 Miro가 등록된 Azure Cards 앱을 업데이트한 경우 관리자는 Microsoft의 동의 흐름을 거치게 됩니다. 관리자가 보게 되는 내용은 Microsoft Entra 테넌트의 동의 설정에 따라 달라집니다(자세한 내용은 Microsoft의 관리자 및 사용자 동의 개요 참조):
- Entra 관리자 승인이 필요하고 통합을 연결하는 관리자가 적절한 권한을 가진 경우: Microsoft 동의 화면에서 조직을 대신하여 동의를 선택할 수 있습니다. 이렇게 하면 Entra 테넌트의 모든 사용자에 대해 앱이 한 번에 승인됩니다.
- 사용자 동의가 허용된 경우: 통합을 연결하는 관리자는 본인만 동의합니다. 다른 각 사용자는 통합을 처음 사용할 때 개별적으로 동의합니다.
- 통합을 연결하는 관리자가 승인 권한이 없는 경우: 사용자는 관리자 승인 필요 메시지를 보고 Microsoft Entra 관리자에게 동의를 요청해야 합니다 — 테넌트에서 허용하는 경우 동의 화면에서 요청을 제출하거나 Entra 관리자에게 직접 연락해 동의를 받아야 합니다.
Enterprise 또는 조직 수준에서 다시 연결
Miro에서 회사 관리자 권한과 Azure Boards에서 Project Collection Admin 그룹 권한이 모두 필요합니다.
- Miro에서 회사 설정 > 앱 및 통합 > 앱 > 앱 관리 > Azure Cards > 설정로 이동하세요.
- 기존 Azure DevOps 인스턴스 옆에서 연결 해제를 선택하세요.
- Azure DevOps 인스턴스를 다시 연결하려면 연결을 선택하세요. 로그인을 위해 Microsoft로 리디렉션됩니다.
- 로그인하면 Miro Azure Cards 앱의 동의 화면이 표시됩니다. 이후 진행은 Entra 권한과 테넌트의 동의 설정에 따라 달라집니다 — 위의 시나리오를 참조하세요.
Enterprise 팀 수준 또는 Business 플랜에서 다시 연결
Miro에서 팀 관리자 권한과 Azure Boards에서 프로젝트 컬렉션 관리자 그룹 권한이 모두 필요합니다.
- Miro에서 팀 설정 > 앱 > Azure Cards로 이동합니다.
- 해당 Azure 인스턴스 옆의 연결 끊기를 선택합니다.
- Microsoft 계정 옆의 연결 끊기를 선택합니다.
- Microsoft 계정을 다시 연결하려면 연결을 선택합니다. 로그인하려면 Microsoft로 리디렉션됩니다.
- 로그인하면 Miro Azure Cards 앱의 동의 화면이 표시됩니다. 이후 진행은 Entra 권한 및 테넌트의 동의 설정에 따라 달라집니다 — 위의 시나리오를 참조하세요.
- Miro로 돌아가 Azure 인스턴스 옆의 연결을 선택해 다시 연결하세요.
- Azure Cards 통합을 사용하는 각 팀에 대해 이 단계를 반복하세요.