이 가이드는 Microsoft 365 계정을 Taskworld와 통합하기 위한 워크스페이스별 1회 설정 과정을 안내합니다. 설정 완료 후에는 파일을 다운로드하거나 다시 업로드하지 않고도 OneDrive 또는 SharePoint에 저장된 파일을 바로 첨부할 수 있습니다.
※ Enterprise 요금제 사용자만 이용 가능합니다.
사전 준비
관리자 권한 필요: 이 설정은 조직 내 Microsoft 365 관리자가 수행해야 합니다.
설정 목적: 회사의 Azure Active Directory(Azure AD)에 새 앱을 등록하여 Taskworld가 SharePoint와 OneDrive 파일에 안전하게 접근할 수 있도록 권한을 부여합니다.
1단계: Azure에서 새 애플리케이션 등록
Azure Portal(https://portal.azure.com/)에 관리자로 로그인합니다.
Azure Active Directory > 앱 등록(App registrations) > +새 등록(New registration)으로 이동합니다.
애플리케이션 정보를 입력합니다:
이름: Taskworld-SharePoint-Integration
지원되는 계정 유형: 이 조직 디렉터리의 계정만 선택
등록(Register) 버튼을 클릭합니다.
2단계: 인증(Authentication) 구성
등록된 앱에서 인증(Authentication) 탭으로 이동합니다.
플랫폼 추가(+ Add a platform) > 단일 페이지 애플리케이션(Single-page application) 선택
리디렉션 URI(Redirect URIs) 입력:
https://{your-workspace-url}/msal-redirect
예시: Taskworld URL이 acmecorp.taskworld.com이라면, https://acmecorp.taskworld.com/msal-redirect.
페이지 하단의 Implicit grant and hybrid flows 항목에서 체크:
☑️ Access tokens (implicit flow용)
☑️ ID tokens (implicit/hybrid flow용)
구성(Configure) 버튼을 클릭하여 저장합니다.
3단계: API 권한 설정
앱의 API 권한(API permissions) 탭으로 이동합니다.
권한 추가(+ Add a permission) > Microsoft Graph 선택
위임된 권한(Delegated permissions) 선택
다음 권한 추가:
Files.Read.All – Taskworld에서 파일을 읽어올 수 있도록 허용
Sites.Read.All – Taskworld에서 SharePoint 사이트를 읽어올 수 있도록 허용
권한 추가(Add permissions) 클릭
[조직 이름]에 대한 관리자 동의(Grant admin consent for [Your Organization Name]) 클릭 후, 확인 창에서 예(Yes) 선택
녹색 체크 표시가 뜨면 승인 완료
4단계: 애플리케이션 정보 수집
앱의 개요(Overview) 탭으로 이동
다음 정보를 복사하여 저장:
애플리케이션(Client) ID
디렉터리(Tenant) ID
5단계: SharePoint 사이트 URL 확인
Microsoft 365 포털(https://m365.cloud.microsoft/) 접속 후 로그인
앱(Apps)에서 SharePoint 실행
SharePoint가 열리면 브라우저 주소창에서 사이트 URL 복사
일반 URL 형식:
https://[테넌트명].sharepoint.com/sites/[사이트 이름]
또는 루트 사이트의 경우:
https://[테넌트명].sharepoint.com
6단계: Taskworld로 정보 전달
모든 단계를 완료한 후, 아래 정보를 CSM 또는 ssupport@taskworld.com으로 전달합니다:
애플리케이션(Client) ID
디렉터리(Tenant) ID
SharePoint 사이트 URL
Taskworld 팀이 귀하의 워크스페이스에 대한 통합 설정을 진행하고, 완료 시 알림을 드립니다.
※ 참고:
이 설정은 워크스페이스별 1회만 필요합니다.
내부 IT 팀의 협조가 필요하며 Microsoft 365 관리자가 수행해야 합니다.