Microsoft SharePoint Online 모듈
Adobe Workfront Fusion 시나리오에서는 Microsoft SharePoint Online을 사용하는 워크플로를 자동화하고 여러 타사 애플리케이션 및 서비스에 연결할 수 있습니다.
시나리오 만드는 방법에 대한 지침은 시나리오 만들기: 문서 색인의 문서를 참조하십시오.
모듈에 대한 자세한 내용은 모듈: 문서 색인의 문서를 참조하십시오.
액세스 요구 사항
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 패키지 |
모든 Adobe Workfront 워크플로 패키지 및 모든 Adobe Workfront 자동화 및 통합 패키지 Workfront Ultimate Workfront Prime 및 Select 패키지 및 Workfront Fusion 추가 구매. |
| Adobe Workfront 라이선스 |
표준 작업 이상 |
| Adobe Workfront Fusion 라이선스 |
운영 기반: 운영 기반 라이센스가 있는 조직에서 사용 가능 커넥터 기반(이전): 작업 자동화 및 통합을 위한 Workfront Fusion |
| 제품 | 조직에 Workfront 자동화 및 통합이 포함되지 않은 Select 또는 Prime Workfront 패키지가 있는 경우 Adobe Workfront Fusion을 구매해야 합니다. |
이 테이블의 정보에 대한 자세한 내용은 설명서의 액세스 요구 사항을 참조하십시오.
Adobe Workfront Fusion 라이선스에 대한 자세한 내용은 Adobe Workfront Fusion 라이선스를 참조하십시오.
전제 조건
Microsoft SharePoint Online 모듈을 사용하려면 Microsoft SharePoint Online 계정이 있어야 합니다.
SharePoint API 정보
SharePoint 커넥터는 다음을 사용합니다.
Microsoft SharePoint Online을 Workfront Fusion에 연결 connect-microsoft-sharepoint-online-to-workfront-fusion
Microsoft 계정을 사용하여 Microsoft SharePoint Online을 Workfront Fusion에 연결
고급 설정을 사용하여 Microsoft SharePoint Online을 Workfront Fusion에 연결
연결에 자격 증명을 포함하려면 고급 설정 표시 옵션을 활성화합니다. 이 유형의 연결에는 클라이언트 ID, 클라이언트 암호 및 테넌트 ID가 필요합니다.
-
모든 SharePoint 모듈에서 연결 필드 옆의 추가를 클릭하여 연결 만들기 상자를 엽니다.
-
고급 설정 표시를 클릭합니다.
-
다음 필드를 채웁니다.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 연결 유형 클라이언트 자격 증명을 사용하려면 Microsoft 365 전자 메일을(를) 선택하십시오. 연결 이름 연결의 이름을 입력합니다. 클라이언트 ID 연결 중인 SharePoint 앱의 클라이언트 ID를 입력합니다. 클라이언트 암호 연결 중인 SharePoint 앱의 클라이언트 암호를 입력합니다. 테넌트 ID 연결 중인 SharePoint 앱의 테넌트 ID를 입력합니다. -
연결을 저장하고 모듈로 돌아가려면 계속을 클릭합니다.
인증서 인증을 사용하여 Microsoft SharePoint Online을 Workfront Fusion에 연결
인증서 인증을 사용하여 SharePoint에 연결할 수 있습니다.
| note important |
|---|
| IMPORTANT |
| 인증서 인증을 사용하려면 먼저 Microsoft Entra에서 앱을 만들고 인증서를 업로드해야 합니다. |
| 자세한 내용은 Microsoft 설명서의 Microsoft Entra 인증서 기반 인증을 위한 인증 기관을 구성하는 방법을 참조하십시오. |
-
모든 SharePoint 모듈에서 연결 필드 옆의 추가를 클릭하여 연결 만들기 상자를 엽니다.
-
고급 설정 표시를 클릭합니다.
-
다음 필드를 채웁니다.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 연결 유형 인증서 인증을 사용하려면 Microsoft SharePoint Online(인증서 인증)을(를) 선택하십시오. 연결 이름 연결의 이름을 입력합니다. 클라이언트 ID 연결 중인 SharePoint 앱의 클라이언트 ID를 입력합니다. Thumbprint 연결 중인 SharePoint 앱의 지문을 입력합니다. 비공개 키 Microsoft에서 자격 증명을 만들 때 생성된 인증서 또는 개인 키를 입력합니다.
비공개 키 또는 인증서를 추출하려면 다음을 수행합니다.
-
추출을 클릭합니다.
-
인증서를 추출할지 또는 개인 키를 추출할지 선택합니다.
-
추출할 파일 유형을 선택합니다.
-
비공개 키 또는 인증서가 포함된 파일을 선택합니다.
-
파일의 암호를 입력합니다.
-
저장을 클릭하여 파일을 추출하고 연결 설정으로 돌아갑니다.
-
-
연결을 저장하고 모듈로 돌아가려면 계속을 클릭합니다.
서비스 주체를 사용하여 Microsoft SharePoint Online을 Workfront Fusion에 연결
개인 계정 대신 서비스 주체(애플리케이션 API 연결)를 사용하는 연결을 만들 수 있습니다. 이 기능은 연결을 특정 사용자가 아닌 애플리케이션이나 서비스 ID로 실행하려는 경우에 유용합니다. 예를 들어, 해당 사용자가 회사를 떠나거나 암호를 변경할 경우 통합이 중단되지 않습니다.
| note important |
|---|
| IMPORTANT |
| 이 연결 유형은 API 호출 만들기 모듈에만 사용할 수 있습니다. 다른 SharePoint 모듈에는 이 문서에 설명된 다른 연결 유형 중 하나가 필요합니다. |
- 서비스 주체를 사용하여 Microsoft SharePoint Online을 Workfront Fusion에 연결하기 위한 사전 요구 사항
- Microsoft Entra ID에서 앱 등록 만들기
- 클라이언트 암호 만들기
- API 권한 부여
- 연결 세부 정보 수집
- 연결 만들기
서비스 주체를 사용하여 Microsoft SharePoint Online을 Workfront Fusion에 연결하기 위한 사전 요구 사항
앱을 등록하고 권한을 부여하려면 Microsoft Entra ID에서 전역 관리자, 응용 프로그램 관리자 또는 권한 있는 역할 관리자 액세스 권한이 필요합니다. 이 액세스 권한이 없는 경우 IT 또는 ID 팀의 사용자에게 이러한 단계를 완료하도록 요청하십시오.
계속해서 Microsoft Entra ID에서 앱 등록을 만듭니다.
Microsoft Entra ID(서비스 주체)에서 앱 등록을 만듭니다.
- Microsoft Entra 관리 센터에 로그인합니다.
- 앱 등록 > 새 등록(으)로 이동합니다.
- 앱에 인식할 수 있는 명확한 이름을 지정합니다. 예:
Make - SharePoint Integration. - 리디렉션 URI을 비워 둡니다. 이 연결에는 브라우저를 통해 로그인하는 사용자가 포함되지 않습니다.
- 등록을 선택하세요.
- 클라이언트 암호를 만드세요.
클라이언트 암호 만들기(서비스 사용자)
- 새 앱 등록에서 인증서 및 암호(으)로 이동합니다.
- 새 클라이언트 암호를 선택하고 설명을 추가한 다음 만료 기간을 선택하십시오.
- 추가를 선택합니다.
- 암호의 값을(를) 즉시 복사합니다. 한 번만 표시됩니다. 복사하기 전에 다른 곳으로 이동하면 새 파일을 만들어야 합니다.
- API 권한 부여를 계속합니다.
API 권한 부여(서비스 주체)
- 앱 등록에서 API 권한(으)로 이동합니다.
- 권한 추가를 선택한 다음 Microsoft 그래프를 선택합니다.
- 응용 프로그램 권한을 선택하십시오.
- API 호출에 필요한 권한을 선택한 다음 권한 추가를 선택합니다.
- 조직에 대한 관리자 동의 부여를 선택한 다음 확인합니다.
- 연결 세부 정보 수집을 계속합니다.
연결 세부 정보 수집(서비스 주체)
앱 등록의 개요 페이지에서 다음 값을 참고하십시오. 모듈에서 연결을 만들 때 이를 입력합니다.
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| 테넌트 ID | 개요 페이지에서 디렉터리(테넌트) ID 레이블이 지정되었습니다. |
| 클라이언트 ID | 개요 페이지에서 응용 프로그램(클라이언트) ID 레이블이 지정되었습니다. |
| 클라이언트 암호 | 클라이언트 암호 만들기에서 복사한 값입니다. |
연결 만들기를 계속합니다.
연결 만들기(서비스 주체)
-
API 호출 만들기 모듈에서 연결 필드 옆의 추가를 클릭하여 연결 만들기 상자를 엽니다.
-
고급 설정 표시를 클릭합니다.
-
연결 유형 필드에서 서비스 주체를 선택합니다.
-
다음을 입력하십시오.
- 테넌트 ID
- 클라이언트 ID
- 클라이언트 암호
-
연결을 저장하고 모듈로 돌아가려면 계속을 클릭합니다.
모든 것이 올바르게 설정되면 연결이 성공적으로 검증됩니다.
페더레이션 연결을 사용하여 Microsoft SharePoint Online을 Adobe Workfront Fusion에 연결
페더레이션 연결은 클라이언트 암호를 사용하지 않는다는 점을 제외하면 서비스 사용자 연결과 같이 작동합니다.
암호를 저장하는 대신, Microsoft Entra ID에 Workfront Fusion이 한 개의 특정 연결에 대해 발급하는 토큰을 신뢰하도록 지시합니다. 연결이 실행되면 Fusion은 짧은 기간 동안 ID 증명을 제공하고 Microsoft Entra ID는 액세스 토큰을 반환합니다. 클라이언트 암호가 없으므로 만료되는 암호와 회전하거나 저장할 암호가 없습니다.
| note |
|---|
| NOTE |
| 이 연결을 설정하려면 Microsoft Entra 관리 센터를 두 번 방문해야 합니다. 먼저 앱을 등록한 다음 Workfront Fusion에서 연결을 만들고 Microsoft Entra ID로 돌아가 페더레이션 자격 증명을 추가합니다. 페더레이션 자격 증명은 하나의 특정 연결을 식별하고, 연결이 만들어져야 해당 식별자가 존재하기 때문입니다. |
- 페더레이션 연결을 사용하여 Microsoft SharePoint Online을 Workfront Fusion에 연결하기 위한 사전 요구 사항
- Microsoft Entra ID(Federated connection)에서 앱 등록 생성
- API 권한 부여(페더레이션 연결)
- 연결 세부 정보 수집(페더레이션 연결)
- Workfront Fusion(페더레이션 연결)에서 연결 만들기
- Microsoft Entra ID(페더레이션 연결)에서 페더레이션 자격 증명 추가
- 연결 확인(페더레이션 연결)
- 문제 해결
페더레이션 연결을 사용하여 Microsoft SharePoint Online을 Workfront Fusion에 연결하기 위한 사전 요구 사항
앱을 등록하고, 권한을 부여하고, 통합 자격 증명을 추가하려면 Microsoft Entra ID에서 전역 관리자, 애플리케이션 관리자 또는 권한이 있는 역할 관리자 액세스 권한이 필요합니다. 이 액세스 권한이 없는 경우 IT 또는 ID 팀의 사용자에게 이러한 단계를 완료하도록 요청하십시오.
Microsoft Entra ID(Federated connection)에서 앱 등록 생성
- Microsoft Entra 관리 센터에 로그인합니다.
- 앱 등록 > 새 등록으로 이동합니다.
- 앱에 인식할 수 있는 명확한 이름을 지정합니다. 예:
Workfront Fusion SharePoint Integration. - 리디렉션 URI를 비워 둡니다. 이 연결에는 브라우저를 통해 로그인하는 사용자가 포함되지 않습니다.
- 등록을 선택하세요.
클라이언트 암호를 만들지 마십시오. 페더레이션된 연결은 이를 사용하지 않습니다. - API 권한을 계속 부여합니다.
API 권한 부여(페더레이션 연결)
- 앱 등록에서 API 권한(으)로 이동합니다.
- 권한 추가를 선택한 다음 Microsoft 그래프를 선택합니다.
- 응용 프로그램 권한을 선택하십시오.
- API 호출에 필요한 권한을 선택한 다음 권한 추가를 선택합니다.
- 조직의 관리자 동의 부여를 선택한 다음 확인합니다.
- 연결 세부 정보 수집을 계속합니다.
연결 세부 정보 수집(페더레이션 연결)
-
앱 등록의 개요 페이지에서 다음 값을 확인합니다. 모듈에서 연결을 만들 때 이를 입력합니다.
table 0-row-2 1-row-2 layout-auto html-authored no-header 테넌트 ID 개요 페이지에서 디렉터리(테넌트) ID 레이블이 지정되었습니다. 클라이언트 ID 개요 페이지에서 응용 프로그램(클라이언트) ID 레이블이 지정되었습니다. -
Workfront Fusion에서 연결 만들기를 계속합니다.
Workfront Fusion(페더레이션 연결)에서 연결 만들기
-
API 호출 만들기 모듈에서 연결 필드 옆의 b를 클릭하여 연결 만들기 상자를 엽니다.
-
(페더레이션 연결)을 클릭합니다.
-
연결 유형 필드에서 연결된 연결 유형을 선택합니다.
-
다음을 입력하십시오.
- 임차인 ID
- 클라이언트 ID
-
Select Create.
Workfront Fusion에는 세 가지 값이 표시됩니다. 다음 절차에서 사용합니다.table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header 발급자 항상 https://oidc.automations.adobe.com입니다.Subject 이 하나의 연결을 식별합니다. fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964(으)로 보입니다. 만드는 모든 연결에 대해 다릅니다.대상 항상 api://AzureADTokenExchange입니다. -
이 패널을 연 상태로 두고 제목 값을 복사하십시오.
note NOTE 패널을 닫거나 취소를 선택하지 마십시오. 나머지 절차를 완료할 때까지 연결이 완료되지 않습니다. 패널을 닫으면 새 연결에 새 제목 이 표시되므로 연결을 삭제하고 다시 시작해야 합니다.
Microsoft Entra ID(페더레이션 연결)에서 페더레이션 자격 증명 추가
이 절차는 클라이언트 암호를 대체하는 절차입니다. 이는 Microsoft Entra ID에게 이 하나의 연결에 대해 Workfront Fusion에서 문제가 되는 토큰을 수락하도록 알려줍니다.
-
새 브라우저 탭에서 Microsoft Entra 관리 센터로 돌아가 앱 등록을 엽니다.
-
인증서 및 암호 > 페더레이션 자격 증명(으)로 이동합니다.
-
자격 증명 추가를 선택합니다.
-
페더레이션 자격 증명 시나리오에서 다른 발급자를 선택하십시오.
-
다음을 입력하십시오.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 발급자 https://oidc.automations.adobe.com.Subject identifier Workfront Fusion에서 복사한 제목입니다. 추가된 공백 없이 정확하게 붙여넣습니다. 이름 나중에 찾을 수 있도록 이 연결을 식별하는 이름입니다. 예: workfront-fusion-connection-28964.대상 api://AzureADTokenExchange. 이것은 보통 당신을 위해 채워집니다. 기본값을 그대로 둡니다. -
추가를 선택합니다.
-
연결 확인을 계속합니다.
연결 확인(페더레이션 연결)
-
연결 패널이 열려 있는 Workfront Fusion 브라우저 탭으로 돌아갑니다.
-
저장을 선택합니다.
- 모든 것이 올바르게 설정된 경우 연결이 성공적으로 검증되고 모듈 설정을 계속할 수 있습니다.
- 확인에 실패하면 패널이 열린 상태로 유지되며 오류가 표시됩니다. Microsoft Entra ID에서 문제를 수정한 후 저장을 다시 선택합니다. 연결을 다시 만들 필요가 없으며 주제도 변경되지 않습니다.
문제 해결
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| 연결이 잘못된 클라이언트 또는 잘못된 요청 오류로 인해 확인에 실패합니다. | Microsoft Entra ID가 토큰을 페더레이션 자격 증명과 일치시킬 수 없습니다. 발급자가 슬래시가 없는 정확히 https://oidc.automations.adobe.com이고 제목 식별자가 Workfront Fusion에 표시된 제목과 문자 대 문자인지 확인합니다. 다른 연결에서 복사된 제목 이 가장 일반적인 원인입니다. |
| 연결은 확인되지만 API 호출은 403을 반환합니다. | ID는 신뢰할 수 있지만 앱에는 호출에 필요한 Microsoft Graph 권한이 없습니다. API 권한 부여로 돌아가서 필요한 애플리케이션 권한을 추가하고 관리자 동의를 부여합니다. |
| 다른 페더레이션 자격 증명을 추가할 수 없습니다. | 해당 앱 등록에 대한 20개의 페더레이션 자격 증명 한도에 도달했습니다. 추가 앱을 등록하고 추가 연결을 만듭니다. |
Microsoft SharePoint 모듈 및 해당 필드
Microsoft SharePoint Online 모듈을 구성하면 Workfront Fusion에 아래 나열된 필드가 표시됩니다. 이러한 필드와 함께 앱이나 서비스의 액세스 수준 등의 요소에 따라 추가 Microsoft SharePoint Online 필드가 표시될 수 있습니다. 모듈의 굵은 글씨 제목은 필수 필드를 나타냅니다.
필드 또는 함수 위에 있는 맵 버튼을 보면 해당 필드의 변수와 함수를 설정하는 데 사용할 수 있습니다. 자세한 내용은 한 모듈에서 다른 모듈로 정보 매핑을 참조하십시오.
드라이브 항목
파일 만들기
이 모듈은 SharePoint에서 파일을 생성합니다. 이 모듈의 성능은 파일 만들기(기존) 모듈보다 뛰어납니다.
파일 만들기(이전)
이 모듈은 SharePoint에서 파일을 만듭니다.
성능을 향상시키려면 파일 만들기 모듈을 사용하는 것이 좋습니다.
폴더 만들기
이 작업 모듈은 SharePoint에 새 폴더를 만듭니다.
파일 가져오기
이 작업 모듈은 지정된 SharePoint 파일을 검색합니다.
폴더 가져오기
이 모듈은 지정된 폴더에 대한 세부 정보를 검색했습니다.
폴더 또는 파일 업데이트
이 작업 모듈은 폴더 또는 파일의 메타데이터를 업데이트합니다.
감시 폴더 항목
이 트리거 모듈은 선택한 폴더에서 항목이 업데이트될 때 시나리오를 시작합니다.
항목
항목 복사
이 작업 모듈은 SharePoint 목록의 기존 항목을 복사합니다.
항목 만들기
이 작업 모듈은 SharePoint 목록에 새 항목을 만듭니다.
항목 삭제
이 작업 모듈은 SharePoint 목록의 기존 항목을 삭제합니다.
항목 가져오기
이 작업 모듈은 지정된 항목의 데이터를 반환합니다.
세부 정보 가져오기
이 모듈은 지정된 URL에서 항목 세부 정보를 가져옵니다.
목록 항목
이 작업 모듈은 지정된 목록의 모든 항목 목록을 검색합니다.
항목 이동
이 작업 모듈은 SharePoint 목록의 기존 항목을 복사합니다.
항목 업데이트
이 작업 모듈은 SharePoint 목록의 기존 항목을 업데이트합니다.
항목 보기(예약됨)
이 트리거 모듈은 항목을 만들거나 수정할 때 시나리오를 시작합니다.
목록
목록 만들기
이 작업 모듈은 SharePoint에 새 목록을 만듭니다.
목록 가져오기
이 작업 모듈은 지정된 목록의 데이터를 반환합니다.
목록
이 작업 모듈은 지정된 사이트의 모든 항목 목록을 검색합니다.
시청 목록
이 트리거 모듈은 목록을 만들거나 수정할 때 시나리오를 시작합니다.
페이지(Beta)
beta 버전의 API는 변경될 수 있습니다. 프로덕션 응용 프로그램에서는 이러한 API를 사용할 수 없습니다.페이지 가져오기
이 작업 모듈은 지정된 페이지의 데이터를 반환합니다.
목록 페이지
이 모듈은 모든 페이지의 목록을 검색합니다.
페이지 게시
이 작업 모듈은 선택한 페이지의 최신 버전을 게시합니다.
시청 페이지
이 트리거 모듈은 지정된 사이트에서 페이지가 수정되면 시나리오를 시작합니다.
사이트
사이트 가져오기
이 작업 모듈은 지정된 사이트의 데이터를 반환합니다.
사이트 검색
이 작업 모듈은 지정한 매개 변수로 사이트를 검색합니다.
기타
변경 사항 가져오기
이 모듈은 SharePoint 폴더에서 만든 추가, 업데이트 및 삭제 작업을 검색합니다.
API 호출 만들기
이 모듈에서는 사용자 지정 API 호출을 수행할 수 있습니다.
이벤트 보기
이 즉시 트리거 모듈은 SharePoint에서 항목이 추가, 업데이트 또는 삭제될 때 시나리오를 시작합니다.