자격 증명 저장소(OAuth 2.0)를 사용하는 Dropbox 오케스트레이션 앱 설치 가이드

개요

사용자, 그룹, 파일 또는 폴더에 대한 작업을 수행하고 Freshservice 티켓에 문서를 첨부합니다.

설명

오케스트레이션 앱은 워크플로우를 사용하여 다양한 시스템 및 애플리케이션 전반에 걸쳐 반복 가능한 작업과 행동을 자동화할 수 있게 해줍니다. 이 앱에서 지원하는 작업 목록은 다음과 같습니다:

파일 및 폴더 관리    

1. Dropbox 파일을 티켓 노트에 첨부

2. 파일 또는 폴더 복사

3. 폴더 생성

4. 파일 또는 폴더 삭제

5. 파일 또는 폴더 메타데이터 가져오기

6. 티켓 첨부파일을 Dropbox에 업로드

사용자 관리    

1. 사용자를 그룹에 추가

2. 사용자를 팀에 추가

3. 그룹 가져오기

4. 사용자의 그룹 멤버십 가져오기

5. 이메일로 사용자 가져오기

6. 사용자를 팀에서 제거

7. 사용자를 그룹에서 제거

8. 사용 가능한 팀 멤버 역할 가져오기

설치 지침

앱 생성

1.  Dropbox 앱 콘솔로 이동합니다(https://www.dropbox.com/developers/apps/).

2.  앱 생성 버튼을 클릭합니다.

3. API 섹션에서 범위 액세스를 선택합니다.

4. 필요한 액세스 유형을 선택하는 섹션에서 전체 Dropbox를 선택합니다.

5. 사용자 정의 앱의 이름을 입력합니다. 예: 'Freshservice Orch'

6. 개인 계정과 비즈니스 계정이 연결되어 있는 경우, 앱 소유 계정을 선택하라는 메시지가 표시됩니다. 선택을 완료하면 해당 계정으로 로그인하라는 메시지가 표시됩니다.

7. 앱 생성 버튼을 클릭합니다. 앱 콘솔로 리디렉션됩니다. 

   1. 이 페이지에서 앱 키와 앱 비밀을 기록해 두십시오. 자격 증명 저장소에 입력해야 합니다. 

8.  권한 탭으로 이동하여 다음 범위를 선택하고 저장합니다

   1. 계정 정보 - 앱이 Dropbox 계정 정보를 보고 관리할 수 있도록 허용하는 권한

      1. account_info.write - 프로필 사진과 같은 Dropbox 계정의 기본 정보를 보고 편집

      2. account_info.read - 사용자 이름, 이메일, 국가와 같은 Dropbox 계정의 기본 정보를 보기

   2. 파일 및 폴더(앱이 파일 및 폴더를 보고 관리할 수 있도록 허용하는 권한)

      1. files.metadata.write - Dropbox 파일 및 폴더에 대한 정보 보기 및 편집

      2. files.metadata.read - Dropbox 파일 및 폴더에 대한 정보 보기

      3. files.content.write - Dropbox 파일 및 폴더의 내용 편집

      4. files.content.read - Dropbox 파일 및 폴더의 내용 보기

   3. 팀 - 앱이 기본 팀 정보를 액세스할 수 있도록 허용하는 권한

      1. team_info.read - 이름, 사용자 수, 팀 설정을 포함한 팀의 기본 정보 보기

      2. Team_data.member - 팀의 구조 및 멤버의 폴더 보기

   4. 파일 - 앱이 팀의 파일 및 폴더를 보고 관리할 수 있도록 허용하는 권한

      1. team_data.team_space - 팀의 파일 및 폴더의 내용 보기 및 편집

      2. files.team_metadata.write - 팀의 파일 및 폴더에 대한 정보 보기 및 편집

      3. Files.permanent_delete - 멤버의 Dropbox 파일 및 폴더 영구 삭제

   5. 멤버 - 팀 멤버십 및 멤버 설정 읽기

      1. members.write - 팀 멤버십 보기 및 관리

      2. members.read - 팀 멤버십 보기

      3. members.delete - 팀 멤버의 계정 제거 및 복구

      4. groups.write - 팀 그룹 멤버십 보기 및 관리, 멤버 계정 제거 및 복구 포함

      5. groups.read - 팀 그룹 멤버십 보기

참고: SaaS Discovery와 함께 작업하려면 다음 범위를 추가해야 합니다

• account_info.read

• team_info.read

• team_data.member

• members.read

• sessions.list

• Events.read

참고:  DropBox API에서 사용되는 장기 액세스 토큰은 더 이상 지원되지 않습니다. 기존의 장기 토큰은 계속 작동하지만, 새로운 토큰은 생성할 수 없습니다. 

9. OAuth2 리디렉션 URI 섹션에 리디렉션 URI를 추가합니다. 이 단계는 자격 증명 저장소를 구성할 때 필요합니다.

   1. 리디렉션 URL: 
      https://<yourdomain.freshservice.com>/api/_/credentials/oauth_callback

참고: 자격 증명 저장소에 대한 자세한 내용은 https://support.freshservice.com/en/support/solutions/articles/50000003816-centralized-credential-store를 확인하세요.

OAuth 2.0 자격 증명을 Freshservice 자격 증명 저장소에 추가

1. Freshservice 포털로 이동  관리자 → 서비스 데스크 생산성 → 자격 증명 저장소.

2.  새 자격 증명을 클릭합니다.

3. 앱 이름을 선택합니다 Dropbox - Orch

4. 클라이언트 ID 및 클라이언트 비밀을 입력합니다(앱 생성, 7단계 - 앱 키 및 앱 비밀)

5.  토큰 생성 및 저장을 클릭하면 새 탭이 열리며 동의를 요청합니다. 동의를 부여하세요.

Dropbox Orchestration 앱에서 자격 증명 사용

1. OAuth 2.0 자격 증명을 성공적으로 구성한 후 오케스트레이션 앱의 설치 화면으로 이동합니다

2. 자격 증명 드롭다운을 클릭하고 새로 생성된 자격 증명을 선택하거나 이름으로 검색합니다

3. Freshservice 도메인 - Freshservice 테넌트의 도메인입니다. 

예: yourcompany.freshservice.com

4. Freshservice API 키 - Freshservice 테넌트에 로그인합니다. 오른쪽 패널에서 프로필 아이콘 -> 프로필 설정을 클릭하고, "당신의 API 키" 아래에서 캡차를 완료하고 API 키를 복사합니다.