대상: 모든 사용자
플랜: Business, Enterprise
플랫폼: 브라우저, 데스크톱, 모바일
Azure Cards는 Azure Boards(구 VSTS, Azure DevOps 서비스의 일부 — 클라우드 솔루션)에서 작업 항목을 가져와 Miro 보드에 추가할 수 있게 해줍니다. 회고, 스토리 사이징, 백로그 우선순위 지정, 스토리 매핑 등 원격 팀 활동에 필수적인 요소가 될 수 있습니다. 또한 Miro 칸반과 유저 스토리맵 프레임워크에서도 사용할 수 있습니다.
Azure Cards는 Azure Boards와 직접 통합되어 다양한 팀 활동에서 원활한 워크플로 관리를 가능하게 해 Miro 경험을 향상합니다.
주요 기능
Azure Cards 통합은 다음과 같은 주요 기능을 제공합니다:
- 앱 내 Azure Boards 작업 항목 선택기를 사용해 Azure 카드를 가져올 수 있습니다. 다양한 정렬 옵션을 제공합니다.
- 앱 내 선택기에서 Azure Boards 작업 항목을 검색할 수 있습니다.
- 확대/축소 시 자동으로 가독성 좋은 카드 보기로 전환됩니다.
✏️ 카드 폴링으로 Azure 카드가 항상 업데이트되도록 보장하세요. 웹훅이 실패하더라도 사용자에게 카드 업데이트가 전달됩니다.
Azure 카드 통합 설정
설정은 두 단계에서 필요합니다:
- 앱은 조직 수준에서 모든 팀에 추가하거나 특정 팀 수준에서 추가해야 합니다.
- 앱이 추가된 후에는 Azure Cards를 가져오려면 통합을 개인 계정 수준에서 연결하고 권한을 승인해야 합니다.
이 프로세스는 Miro와 Azure DevOps 양쪽에서 특정 관리자 권한을 필요로 합니다.
✏️ Miro에서 Azure Cards를 성공적으로 설정하려면 Azure 관리자와 Miro 관리자는 동일한 계정이어야 합니다.
Azure Cards를 추가하려면 Miro의 팀 관리자 또는 회사 관리자 권한 및 Azure Boards의 Project Collection Admin 그룹 권한이 필요하지만, 연결이 완료된 후에는 이러한 권한을 낮출 수 있습니다. 다만 해당 관리자는 제거할 수 없으며 Azure 프로젝트에 대한 접근 권한을 유지해야 합니다.
조직 또는 팀에 Azure Cards 추가
Miro 회사 관리자는 모든 팀에 Azure Cards를 추가할 수 있고, 팀 관리자는 자신이 관리하는 특정 팀에 추가할 수 있습니다. 이 단계에서 Azure Cards 앱을 연결할 수 있게 됩니다.
✏️ 팀 수준에서 Azure Cards를 연결하려면 팀 관리자여야 합니다.
- 프로필 설정으로 이동합니다. 메인 메뉴의 햄버거 아이콘을 클릭해 프로필 설정을 선택하거나 대시보드 오른쪽 상단의 아바타를 클릭해 설정을 선택합니다.
- 앱을 클릭한 다음 오른쪽의 앱 추가 탭으로 이동합니다.
- 검색창에 "Azure Cards"를 입력하고 드롭다운 목록에서 선택한 다음 Add를 클릭합니다.
- 다음 대화 상자에서 모든 팀 또는 특정 팀을 선택하고 필요하면 팀을 지정한 다음 다음 단계를 클릭합니다.
- "Azure Cards 검토 및 추가" 화면에서 Add를 클릭합니다. 앱이 회사 또는 팀에 추가됩니다.
- Go to the Manage apps tab, search for Azure Cards, and click Approve. The app will now be approved at the company- or team-level.
- 다음으로 Azure 조직을 Miro에 연결합니다. 앱 패널에서 앱 관리로 이동하세요.
- 앱 목록에서 "Azure Cards"를 검색한 다음 설정을 클릭하세요.
-
Azure Cards의 설정 패널에서 Azure 인스턴스 URL을 추가하고 연결을 클릭하세요. Microsoft Azure 로그인 신원 정보를 입력하세요.
-
권한 부여 대화 상자에서 수락을 클릭해 Azure와 Miro 연결을 완료하세요.
특정 팀에 대한 Azure Cards 사용자 지정 설정 적용
회사 전체 구성과 다른 설정을 특정 팀에 적용해야 하는 경우, 팀 관리자는 팀의 앱 및 통합에서 이를 구성할 수 있습니다.
- 프로필 설정 페이지에서 팀을 클릭합니다.
- 사용자 지정 설정을 적용할 팀을 클릭합니다.
- 팀 패널에서 앱 및 통합을 클릭합니다.
- 찾아 Azure Cards를 클릭합니다.
- 앱 설정 패널에서 오른쪽 드롭다운에서 맞춤형 설정 적용을 선택하고, 맞춤형 설정을 적용할 Azure 계정을 연결하세요.
- Azure DevOps에서 Miro에 권한을 부여하려면: "Microsoft 계정" 옆의 연결을 클릭해 Microsoft 계정으로 로그인하고 Miro가 계정을 사용하도록 허용하세요.
- Azure DevOps에서 복사할 수 있는 Azure 조직 URL을 입력하고 연결.을 클릭하세요. Miro는 인스턴스의 개인화된 URL 또는 인스턴스 이름으로 끝나는 일반 https://dev.azure.com/ 주소를 모두 허용합니다.
특정 팀에 사용자 지정 Azure 카드 설정 추가
Azure 카드를 사용하려면 개인 Azure 계정을 연결하세요
Miro 관리자가 앱을 설치하고 승인하면, Azure Cards를 사용하려는 각 팀원은 개인적으로 자신의 Azure 계정 연결을 승인해야 합니다. 이렇게 하면 카드 선택기가 개인화되고 사용자가 접근할 수 있는 모든 Azure 작업 항목을 가져올 수 있습니다.
작성 툴바에서 Azure Cards 아이콘을 찾을 수 있습니다. 아이콘이 보이지 않으면 검색해야 할 수도 있습니다:
- 작성 툴바에서 도구, 미디어 및 통합(+)을 선택하세요.
도구, 미디어 및 통합 패널이 열립니다. - 도구 탭에서 Azure Cards를 검색해 선택하세요.
계정을 연결하려면:
- 툴바에서 Azure Cards 아이콘을 클릭하세요. 팝업이 나타나면 승인하라는 메시지가 표시됩니다.
- 승인 버튼을 클릭한 후 계속을 클릭하세요. 팀 설정 > 앱 및 통합 페이지로 이동합니다.
- 앱 설정 패널을 사용해 Microsoft 계정을 Miro에 연결하고 사용할 Azure 인스턴스를 지정하세요. 이 URL은 Azure DevOps에서 복사할 수 있습니다. Miro는 인스턴스의 개인화된 URL이나 인스턴스 이름으로 끝나는 일반 https://dev.azure.com/ 주소를 모두 허용합니다.
✏️ 참고: 초기 팀 또는 회사 수준 구성을 설정할 수 있는 권한은 팀 관리자에게만 있습니다. 관리 설정 중 Azure 조직 URL에 대한 연결 버튼이 보이지 않으면, 해당 팀의 팀 관리자 권한이 있는지 확인하세요.
Miro 보드에 Azure 작업 항목 가져오기
Azure Cards 앱을 구성하고 개인 계정을 연결하면, 연결된 팀에 속한 모든 Miro 보드로 Azure 작업 항목을 가져올 수 있습니다. 이를 수행하는 주요 방법은 다음 두 가지입니다:
- Azure 작업 항목 URL을 복사해 Miro 보드에 바로 붙여넣으면 항목이 자동으로 Azure 카드로 변환됩니다.
-
Azure Cards 피커 사용: 툴바에서 Azure Cards 아이콘을 클릭해 피커를 엽니다.
Azure Cards 피커
픽커는 모든 필드에서 검색을 지원해 제목, 유형, 상태 등으로 카드를 찾을 수 있습니다. 또한 Microsoft에서 제공하는 강력한 키워드 검색을 사용할 수 있습니다.
픽커에서 Azure Cards 검색
프로젝트, 담당자, 유형, 영역, 상태별로 카드를 필터링할 수 있어 Miro에서 Azure 작업 항목을 직접 고급 필터링할 수 있습니다.
픽커에서 Azure 카드 필터링
원래 Azure 작업 항목으로 이동하려면 보드에서 카드를 선택한 후 해당 카드의 컨텍스트 메뉴에서 원본 버튼을 클릭하세요.
Azure 카드는 단독 보드 위젯으로 사용하거나 인터랙티브한 칸반 및 유저 스토리맵 프레임워크의 구성 요소로 사용할 수 있습니다. 이들 프레임워크에 Azure 카드를 드래그해 추가할 수 있습니다.
Miro에서 Azure 카드를 직접 생성하고 편집하기
Miro와 Azure DevOps 간의 양방향 통합을 통해 팀은 Miro 보드에서 직접 새 Azure 작업 항목을 만들고 기존 항목을 편집할 수 있습니다. 기존 Miro 카드나 스티커 메모를 Azure Cards로 변환할 수도 있습니다.
새 Azure Cards 만들기
Miro에서 새 Azure 작업 항목을 만들려면:
- 작성 툴바에서 Azure Cards를 선택하고 피커 우측 상단에서 작업 항목 만들기를 선택하세요.
- 카드 필드를 작성하고 프로젝트, 항목 유형, 담당자를 선택한 다음 생성을 클릭합니다. 새 항목은 Azure DevOps 디렉터리와 Miro 보드에 모두 생성됩니다.
Miro 카드 또는 스티커 메모를 Azure Cards로 변환하기
기존 Miro 카드나 스티커 메모를 Azure Cards로 변환하려면:
- 보드에서 스티커 메모나 카드를 선택하세요.
- 객체의 컨텍스트 메뉴에서 변환 옵션(보통 Azure DevOps 아이콘이나 "Azure 작업 항목으로 변환")을 클릭하세요.
- 대화 상자에서 프로젝트, 항목 유형 등 카드 매개변수를 설정한 후 변환을 클릭하세요. 스티커 메모나 카드의 텍스트가 카드 제목으로 변환됩니다.
💡 스티커 메모나 Miro 카드를 Azure 카드로 일괄 변환해 시간을 절약하세요. 변환할 모든 객체를 클릭해 드래그로 선택한 다음, 컨텍스트 메뉴에서 Azure 작업 항목으로 변환을 선택하세요.
Azure 카드 편집
Miro에서 Azure 카드를 편집하면 도구를 전환하는 번거로움을 줄일 수 있습니다. 카드를 편집하려면:
- Miro 보드에서 Azure Card를 클릭하세요.
- 카드의 컨텍스트 메뉴에서 펜 아이콘(편집)을 클릭하세요. 팝업 창이 열리며 항목의 필드를 편집할 수 있습니다.
- 변경 사항을 저장하려면 업데이트를 클릭하세요. 변경 사항은 Azure DevOps에도 반영됩니다.
Azure Card 색상 변경
보드에서 Azure Cards의 표시를 사용자 지정하려면:
카드 하나 또는 여러 카드를 클릭한 다음 컨텍스트 메뉴에서 채우기 색상을 선택해 카드의 채우기 색을 변경하세요. 카드를 복제하면 이후에 생성되는 모든 사본에 동일한 채우기 색상이 적용됩니다.
Azure Cards 통합 제거
Azure Cards 통합이 더 이상 필요 없으면 제거할 수 있습니다. 팀 수준에서 제거하려면 팀 관리자 권한이 필요합니다.
- 팀 설정 > 앱 및 통합 > Azure Cards로 이동하세요.
- 팀에서 제거를 선택하세요.
지원되는 Azure 카드 필드
Miro의 Azure 카드에서 다음 필드가 지원됩니다:
- 제목
- 프로젝트
- 유형
- 상태
- 설명 (편집은 지원되지 않습니다)
- 상위 작업 항목
- 담당자
- 우선순위
- 스토리 포인트
- 영역
- 반복
- 허용 기준
사용자 지정 필드는 지원되지 않습니다.
Azure Cards 문제 해결
Azure Cards 통합에 문제가 발생하면 아래의 일반적인 문제와 해결 방법을 확인하세요.
입력한 URL이 존재하지 않습니다. 올바른 URL을 입력하거나 철자를 확인하세요. 또한 다음 사항을 확인하세요:
- 조직에서 타사 권한 부여를 허용하는지 확인하세요: 조직 설정 > 정책(보안) >에서 "OAuth를 통한 타사 애플리케이션 액세스"가 활성화되어 있는지 확인하세요.
- Azure 조직이 사설 네트워크에 있거나 회사 방화벽이 외부 네트워크 연결을 차단하고 있습니다. 방화벽 및 VPN 설정을 변경해 다음 도메인을 허용 목록에 추가하세요: miro.com*, *.miro.com, mirostatic.com*, *.mirostatic.com, realtimeboard.com*, *.realtimeboard.com, *static.miro-apps.com. 프록시를 사용하는 경우 당사가 접근할 수 있도록 리버스 프록시를 구성하세요. 설정의 Azure DevOps URL 필드에 Miro에서 접근 가능한 주소를 반드시 입력하세요. 이 주소는 제한된 Azure DevOps의 실제 주소와 다를 수 있습니다. 프록시 서버의 타임아웃 값을 늘리면 도움이 될 수 있습니다.
- 해당 통합에 대한 모든 요청은 Amazon 로드 밸런서를 경유하므로 Miro에서는 특정 네트워크 정보를 제공할 수 없습니다.
현재 로그인한 Azure 사용자에게 필요한 권한이 없습니다. Azure 인스턴스를 Miro에 연결하는 사용자는 다음 REST API 메서드에 접근 권한이 있어야 합니다:
- 서비스 후크 구독 생성 ("vso.serviceendpoint_manage" 범위 필요)
- 프로젝트에 대한 메타데이터 수신(이 정보는 구독 이벤트에서 작업 항목을 올바르게 지정하는 데 사용됩니다)
- 통합을 사용하는 모든 사용자가 다음 메서드에도 접근할 수 있어야 합니다:
팀 관리자 권한이 있는지 확인하세요. 팀 설정의 활성 사용자 탭으로 이동해 필요하면 자신을 팀 관리자로 승격하세요. 이 내용은 관리자가 Azure 조직 연결을 처음 설정할 때 적용됩니다.
✏️ 다른 문제가 발생하면 Miro 지원에 문의하세요.
Azure Cards 자주 묻는 질문
Azure Cards 통합에 대한 자주 묻는 질문과 답변입니다.
Azure Cards 통합이 정상 작동하려면, 특히 네트워크가 제한된 환경에서는 다음 IP 주소들을 허용 목록에 추가해야 할 수 있습니다:
18.203.61.162 54.220.74.201 54.216.81.236 54.73.153.141 52.215.228.26 52.16.47.17 54.217.180.21