SAP ERP

SAP ERP는 SAP SE에서 개발한 엔터프라이즈 리소스 계획 소프트웨어입니다. SAP ERP는 조직의 주요 비즈니스 기능을 통합합니다. SAP ERP 커넥터를 사용하면 온-프레미스 데이터 게이트웨이를 사용하여 RFC 및 BAPI 함수를 호출할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	Regions
Copilot Studio	Premium	모든 Power Automate 지역
Power Apps	Premium	모든 Power Apps 지역
Power Automate	Premium	모든 Power Automate 지역

연락처
이름	Microsoft
URL	https://learn.microsoft.com/connectors/saperp/

커넥터 메타데이터
게시자	Microsoft
웹 사이트	https://www.sap.com/products/enterprise-management-erp.html
개인 정보 보호 정책	https://www.sap.com/about/legal/privacy.html
카테고리	생산력

SAP ERP 커넥터 사용

이 커넥터 사용을 시작하려면 다음 블로그 게시물을 읽어보세요.

Pre-requisites

SAP ERP 커넥터는 동일한 컴퓨터에 설치해야 하는 다음 구성 요소에 종속됩니다.

온-프레미스 데이터 게이트웨이 (버전 2023년 10월 - 3000.194 이상)
Microsoft C++ 런타임 DLL 버전 14.x(Visual Studio 2015, 2017, 2019 및 2022) (SAP NCo 종속성)
SAP의 SAP .NET 커넥터
- NCo 3.1 64비트 버전 선택(32비트가 지원되지 않음)
- NCo 3.0(지원되지 않음)을 설치하지 마세요.
- 다운로드 액세스를 위해 유효한 S-사용자가 필요합니다. SAP 팀에 문의해야 할 수도 있습니다.

SAP 권한 부여

SAP 사용자 계정은 다음 작업을 위해 RFC_METADATA 함수 그룹 및 해당 함수 모듈에 액세스해야 합니다.

Operations	함수 모듈에 대한 액세스
RFC 작업	`RFC_GROUP_SEARCH`, `DD_LANGU_TO_ISOLA`
BAPI 작업	`BAPI_TRANSACTION_COMMIT`, `BAPI_TRANSACTION_ROLLBACK`, `RPY_BOR_TREE_INIT`, `SWO_QUERY_METHODSSWO_QUERY_API_METHODS`
IDoc 작업	`IDOCTYPES_LIST_WITH_MESSAGES`, `IDOCTYPES_FOR_MESTYPE_READ`, `INBOUND_IDOCS_FOR_TID`, `OUTBOUND_IDOCS_FOR_TID`, `GET_STATUS_FROM_IDOCNRIDOC_RECORD_READ`
SAP 테이블 작업 읽기	`RFC BBP_RFC_READ_TABLE` 또는 `RFC_READ_TABLE`
최소 액세스	`RFC_METADATA_GET`, `RFC_METADATA_GET_TIMESTAMP`

Authentication

커넥터는 SAP 인증, Windows 인증, Kerberos를 사용하는 Microsoft Entra ID 및 인증서가 있는 Microsoft Entra ID를 지원합니다.

커넥터는 앱의 여러 사용자가 사용하도록 설계되었기 때문에 연결이 공유되지 않습니다. 대신 각 사용자는 SAP 시스템을 사용하여 인증합니다. 사용자 자격 증명은 연결에 제공되지만 SAP 시스템에 연결하는 데 필요한 추가 세부 정보(예: 서버 세부 정보, 보안 구성)는 작업의 일부로 제공됩니다.

SAP 인증

SAP 사용자 이름 및 암호를 사용하는 기본 SAP 인증입니다.

Windows 인증

SNC(Secure Network Communication)에 대한 추가 설정이 필요합니다. Power Platform에서 온-프레미스 데이터 원본으로 Kerberos 기반 SSO에 대한 추가 설정이 필요합니다.

Microsoft Entra ID(Kerberos 포함)

Microsoft Entra ID(인증서 포함)

SNC(Secure Network Communication)에 대한 추가 설정이 필요합니다. Power Platform에서 온-프레미스 데이터 원본으로 인증서 기반 SSO에 대한 추가 설정이 필요합니다.

Kerberos 기반 SSO 구성

사용자(p:CN=JANEDOE@REDMOND.CORP.CONTOSO.COM)의 SAP SNC 이름은 Windows 및 Microsoft Entra ID 인증 모두에 대한 Microsoft Entra ID 정규화된 도메인 이름(JANEDOE@REDMOND.CORP.CONTOSO.COM)과 같아야 합니다.

SAP SNC 이름

재산	Description
SNC 사용	SNC를 사용하도록 설정하려면 "예"로 설정
SNC 라이브러리	NCo 설치 위치 또는 절대 경로를 기준으로 하는 SNC 라이브러리 이름 또는 경로입니다. 예는 `sapcrypto.dll` 또는 `.\security\sapcrypto.dll`, 또는 `c:\security\sapcrypto.dll`.
SNC SSO	커넥터가 서비스의 ID를 사용할지 또는 최종 사용자 자격 증명을 사용할지 여부를 지정합니다.
SNC 내 이름	필요한 경우 사용할 ID를 지정합니다.
SNC 파트너 이름	백 엔드 SNC 서버의 이름
SNC 보호 품질	이 특정 대상 또는 서버의 SNC 통신에 사용할 서비스 품질입니다. 기본값은 백 엔드 시스템에 의해 정의됩니다. 최대값은 SNC에 사용되는 보안 제품에 의해 정의됩니다.

SAP ERP 커넥터에 Microsoft Entra ID 또는 Windows 인증이 필요한 경우 다음을 수행해야 합니다.

Power Platform에서 온-프레미스 데이터 원본으로 Kerberos 기반 SSO 구성
CommonCryptoLib를 사용하도록 SAP ERP 구성(sapcrypto.dll)

Power Platform에서 온-프레미스 데이터 원본으로 Kerberos 기반 SSO 구성 필수 구성

데이터 게이트웨이를 설치한 후 게이트웨이는 컴퓨터 로컬 서비스 계정인 NT Service\PBIEgwService로 실행됩니다. Kerberos 제한 위임을 사용하도록 설정하려면 다음 두 가지 옵션이 있습니다.

게이트웨이는 도메인 계정으로 실행되어야 합니다. 게이트웨이 서비스 계정을 변경하는 방법에 대한 설명서를 참조하세요 . 또는
Microsoft Entra ID 인스턴스를 로컬 Microsoft Entra ID 인스턴스와 동기화합니다(Microsoft Entra ID DirSync/Connect 사용).

구성 단계:

도메인 관리자 권한을 획득하여 SPN(SetSPN) 및 Kerberos 제한 위임 설정을 구성합니다.
게이트웨이 및 데이터 원본에 대한 Kerberos 제한 위임 구성
게이트웨이 서비스 계정에 대한 SPN 구성
필요한 경우 Windows 권한 부여 및 액세스 그룹에 게이트웨이 서비스 계정 추가
사용할 Kerberos 제한 위임 유형을 결정합니다.
- 표준 Kerberos 제한 위임에 대한 게이트웨이 서비스 계정 구성
- 리소스 기반 Kerberos 제한 위임에 대한 게이트웨이 서비스 계정 구성
게이트웨이 컴퓨터에 게이트웨이 서비스 계정 로컬 정책 권한 부여
게이트웨이 컴퓨터에서 사용자 매핑 구성 매개 변수 설정(필요한 경우)

이를 구성하는 방법에 대한 자세한 내용은 Power BI 서비스에서 온-프레미스 데이터 원본으로 Kerberos 기반 SSO 구성에 대한 Power BI 설명서를 참조하세요.

CommonCryptoLib를 사용하도록 SAP ERP 구성(sapcrypto.dll)

CommonCryptoLib을 사용하여 Kerberos SSO에 대해 SAP ERP 서버가 올바르게 구성되었는지 확인합니다. 이 경우 SSO를 사용하여 CommonCryptoLib을 사용하도록 구성된 SAP GUI와 같은 SAP 도구를 사용하여 SAP ERP 서버에 액세스할 수 있습니다. 설정 단계에 대한 자세한 내용은 SAP Single Sign-On: Kerberos/SPNEGO를 사용하여 인증을 참조하세요. 서버는 CommonCryptoLib을 SNC 라이브러리로 사용하고 CN으로 시작하는 SNC 이름을 가져야 합니다. SNC 이름 요구 사항(특히 snc/identity/as 매개 변수)에 대한 자세한 내용은 Kerberos 구성에 대한 SNC 매개 변수를 참조하세요.
게이트웨이가 설치된 컴퓨터에서 SAP SLC(Secure Login Client)가 실행되고 있지 않은지 확인합니다. SLC는 게이트웨이가 Kerberos for SSO를 사용하는 기능을 방해할 수 있는 방식으로 Kerberos 티켓을 캐시합니다. SLC가 설치된 경우 SLC를 제거하거나 SAP Secure Login Client를 종료해야 합니다. 시스템 트레이에서 아이콘을 마우스 오른쪽 단추로 클릭하고 게이트웨이를 사용하여 SSO 연결을 시도하기 전에 로그아웃 및 종료를 선택합니다. SLC는 Windows Server 컴퓨터에서 사용할 수 없습니다. 자세한 내용은 SAP Note 2780475(s-user required)를 참조하세요.

SAP Secure Login Client

SLC를 제거하거나 로그아웃 및 종료를 선택하는 경우 cmd 창을 열고 게이트웨이를 통해 SSO 연결을 시도하기 전에 캐시된 Kerberos 티켓을 지우려면 입력 klist purge 합니다.
SAP 실행 패드에서 64비트 CommonCryptoLib(sapcrypto.dll) 버전 8.5.25 이상 다운로드하여 게이트웨이 컴퓨터의 폴더에 복사합니다. 복사 sapcrypto.dll한 동일한 디렉터리에서 다음 콘텐츠를 사용하여 이름이 지정된 sapcrypto.ini파일을 만듭니다.

ccl/snc/enable_kerberos_in_client_role = 1

이 파일에는 .ini 게이트웨이 시나리오에서 SSO를 사용하도록 설정하기 위해 CommonCryptoLib에 필요한 구성 정보가 포함되어 있습니다.

비고

이러한 파일은 동일한 위치에 저장해야 합니다. 즉, /path/to/sapcrypto/ 두 가지를 모두 sapcrypto.inisapcrypto.dll포함해야 합니다.

게이트웨이 서비스 사용자와 서비스 사용자가 가장하는 Microsoft Entra ID 사용자 모두 두 파일에 대한 읽기 및 실행 권한이 필요합니다. 인증된 사용자 그룹에 파일 및 .dll 파일에 대한 .ini 사용 권한을 부여하는 것이 좋습니다. 테스트를 위해 게이트웨이 서비스 사용자와 테스트에 사용하는 Microsoft Entra ID 사용자에게 이러한 권한을 명시적으로 부여할 수도 있습니다. 다음 스크린샷에서는 인증된 사용자 그룹에 다음에 대한 sapcrypto.dll읽기 및 실행 권한을 부여했습니다.

인증된 사용자 권한 부여 권한에 대한 읽기 및 실행

SSO 연결을 통과하려는 게이트웨이와 연결된 SAP BW 데이터 원본이 아직 없는 경우 Power BI 서비스의 게이트웨이 관리 페이지에 하나를 추가합니다. 이러한 데이터 원본이 이미 있는 경우 다음을 편집합니다.

BW 애플리케이션 서버에 대한 SSO 연결을 만들려면 SAP Business Warehouse를 데이터 원본 형식으로 선택합니다.
BW 메시지 서버에 대한 SSO 연결을 만들려면 Sap Business Warehouse 메시지 서버를 선택합니다.

시스템 환경 변수를 CCL_PROFILE 만들고 해당 값을 경로 sapcrypto.ini로 설정합니다.

CCL_PROFILE 시스템 환경 변수:

시스템 환경 변수 환경 변수 만들기 및 설정

파일과 .ini 파일은 sapcrypto.dll 동일한 위치에 있어야 합니다. 위의 예제 sapcrypto.inisapcrypto.dll 에서 둘 다 바탕 화면에 있습니다.

게이트웨이 서비스를 다시 시작합니다.

게이트웨이 서비스 다시 시작

Microsoft Entra ID 인증

이 인증 유형은 다음 작업에서만 작동합니다.

SAP 함수 호출(V2)
상태 저장 세션 만들기
구문 분석으로 SAP 테이블 읽기

Microsoft Entra ID SAP 서비스 주체 계정에는 특성에 AES 128 또는 AES 256이 msDS-SupportedEncryptionType 정의되어야 합니다. 이 블로그 게시물에는 지원되는 암호화 유형에 대한 10진수/16진수 값을 계산하는 데 도움이 되는 테이블이 포함되어 있습니다.

알려진 문제 및 제한 사항

다음은 SAP ERP 커넥터의 알려진 문제 및 제한 사항 중 일부입니다.

커넥터는 RFC 및 BAPI만 지원합니다.
커넥터는 SAP Server에서 메시지 수신을 지원하지 않습니다.
TRFC(트랜잭션 RFC)는 지원되지 않습니다.
게이트웨이에는 쓰기 작업에 대한 2MB 페이로드 제한 과 읽기 작업에 대한 8MB 압축 데이터 응답 제한이 있습니다.
부하 분산 모드의 데이터 게이트웨이 클러스터는 상태 저장 SAP 작업에서 지원되지 않습니다. 상태 저장 통신은 동일한 데이터 게이트웨이 클러스터 노드에 남아 있어야 합니다. 상태 저장 SAP 작업의 경우 비클러스터 모드 또는 장애 조치(failover)로만 설정된 클러스터에서 데이터 게이트웨이를 사용합니다.
다음과 유사한 흐름을 작성하는 동안 오류가 발생하는 경우 온-프레미스 데이터 게이트웨이를 최신 버전 으로 업그레이드합니다. Length of the name of the RFC '<RFC_NAME>?honorSapOptionalFlag=1' is larger than the maximum allowed limit of 30
SAP에서 가져온 RFC/BAPI 매개 변수는 온-프레미스 데이터 게이트웨이 내에서 캐시됩니다. 온-프레미스 데이터 게이트웨이 서비스를 다시 시작하여 캐시를 지우고 새 값을 검색합니다.

로그 수집

다음 로그는 Microsoft 지원에 문의할 때 SapErp 커넥터 문제를 해결하는 데 유용합니다.

온-프레미스 데이터 게이트웨이 앱의 설정에서 Diagnostics SAP Additional logging 어댑터의 확장 로그 및 SapErp 어댑터의 추적을 가져올 수 Informational 있도록 설정합니다.
구성 파일 Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config에서 다음 설정을 업데이트합니다. 일반적으로 이 구성 파일은 온-프레미스 데이터 게이트웨이가 설치된 위치에 있습니다(예: C:\Program Files\On-premises data gateway\Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config).
```
<setting name="SapTraceLevel" serializeAs="String">
   <value>Verbose</value>
</setting>
```

SAP 시스템 속성 지침

매개 변수를 SAP system 지원하는 작업의 경우 다음 표를 참조하세요.

재산	Description
AppServerHost	SAP 애플리케이션 서버의 호스트 이름입니다.
AppServerService	연결할 특정 SAP 애플리케이션 서버의 서비스 이름 또는 포트 번호입니다(연결 유형(로그온의 경우 선택 사항) A - 애플리케이션 서버).
클라이언트	SAP 시스템에 연결할 SAP 클라이언트 ID입니다. 로그인할 SAP 백 엔드 클라이언트(또는 'Mandant')입니다. 000에서 999까지의 숫자입니다.
Language	SAP 시스템에 연결할 언어 코드입니다. 두 문자 ISO 639-1 코드입니다. SAP 내에 설치해야 합니다. 이렇게 하면 브라우저 언어 설정이 재정의됩니다.
LogonGroup	메시지 서버가 애플리케이션 서버를 선택해야 하는 SAP 시스템의 로그온 그룹(연결 유형(로그온)이 B인 경우에만 사용 가능 - 메시지 서버(그룹))
로그온 유형	SAP 시스템에 대한 로그온 유형으로, 애플리케이션 서버 로그온(형식 A) 또는 그룹 로그온(B 형식 메시지 서버)입니다. 허용되는 값: ApplicationServer, Group
MessageServerHost	SAP 시스템의 메시지 서버(중앙 인스턴스) 즉, R3 시스템 이름(연결 유형(로그온)이 B인 경우 필수 - 메시지 서버(그룹))의 호스트 이름입니다.
MessageServerService	서비스 이름(etc/services에 정의된 대로) 또는 메시지 서버가 부하 분산 요청을 수신 대기하는 포트 번호(연결 유형(로그온)가 B인 경우 필수 - 메시지 서버(그룹) 및 시스템 ID가 없음)입니다.
SafeTyping	기본적으로 SAP 연결을 만들 때 스키마에 대한 유효성 검사를 수행하여 잘못된 값을 확인하는 데 강력한 입력이 사용됩니다. 이 동작은 이전에 문제를 감지하는 데 도움이 될 수 있습니다. 안전 입력 옵션은 이전 버전과의 호환성을 위해 사용할 수 있으며 문자열 길이만 확인합니다. 허용되는 값: true, false
SncCertificate	시작 또는 끝 인증서 태그가 없는 Base64로 인코딩된 형식의 X.509 인증서입니다.
SncMyName	설치된 SNC 솔루션은 일반적으로 자체 SNC 이름을 알고 있습니다. '여러 ID'를 지원하는 솔루션에 대해서만 이 대상/서버에 사용할 ID를 지정해야 할 수 있습니다(선택 사항). 이 매개 변수는 대/소문자를 구분하므로 SAP Basis 관리자에게 올바른 값을 확인합니다.
SncLibraryPath	사용할 SNC 라이브러리의 이름 또는 경로입니다. 온-프레미스 데이터 게이트웨이를 사용하면 경로가 NCo 라이브러리에 대한 절대 또는 상대 경로일 수 있습니다.
SncPartnerName	백 엔드의 SNC 이름(로그온 유형이 Application Server인 경우 필수)입니다. 이 매개 변수는 대/소문자를 구분하므로 SAP Basis 관리자에게 올바른 값을 확인하세요.
SncQop	이 대상/서버의 SNC 통신에 사용할 서비스 품질입니다. 허용되는 값: 인증, 무결성, 개인 정보, 기본값, 최대값
SncSso	SNC SSO는 RFC 수준에서 제공된 SNC ID 또는 자격 증명을 사용할지 여부를 지정합니다.
SsoCertificateSubject	Microsoft Entra ID를 사용한 인증서 기반 인증을 위한 OPDG Windows 컴퓨터의 인증서 주체
SystemId	SAP 시스템의 세 글자 시스템 ID(연결 유형(로그온)가 B인 경우 필수 - 메시지 서버(그룹) 및 메시지 서버 서비스가 없는 경우).
SystemNumber	SAP 시스템의 시스템 번호입니다. 00에서 99까지의 숫자입니다(연결 유형(로그온)가 A인 경우 필수 - 애플리케이션 서버).
UseSnc	이 옵션을 선택하면 연결이 SNC로 보호됩니다. 허용되는 값: 예

`Call SAP Function`에서 `Call SAP Function (v2)`로 마이그레이션

Call SAP Function 2023년 7월에는 더 이상 사용되지 않으며, 지원은 2026년 7월에 종료됩니다. 사용자는 해당 시간 전에 기존 v1 작업을 마이그레이션해야 합니다. 그렇지 않으면 흐름이 중단됩니다.

여러 양식 필드를 연결 속성에 대한 단일 JSON 문자열로 대체합니다.
다음 속성 매핑을 사용합니다.

v1 필드 레이블	v2 속성
AS 호스트	AppServerHost
클라이언트	클라이언트
AS 시스템 번호	SystemNumber
SAP 함수 이름	해당 없음 - 연결 문자열과 관련이 없음
상태 저장 세션	해당 없음 - 상태 저장 세션은 ID를 지정할 `Session Id`수 있는 "고급 옵션"에서 사용할 수 있습니다. 동일한 단계를 동일한 `Session Id` 상태 저장 세션의 일부로 실행합니다.
SNC 사용	UseSnc
SNC 라이브러리	SncLibraryPath
SNC SSO	SncSso
SNC 내 이름	SncMyName
SNC 파트너 이름	SncPartnerName
SNC 보호 품질	SncQop

Example

SAP 함수 V1 호출:

SAP 함수 v1 호출

SAP 함수 V2 호출:

SAP 함수 v2 호출

스크린샷이 제공되면 연결 문자열은 다음과 같습니다.

{
  "AppServerHost": "sap.example.com",
  "Client": 100,
  "SystemNumber": "00"
}

Use SNC 스크린샷의 "아니요"이므로 속성이 필요하지 않습니다. 기본값은 "false"입니다.

환경 변수 사용

솔루션에 기본 제공되는 흐름은 환경 변수를 사용하여 이러한 연결 문자열을 관리할 수 있습니다. 환경에 따라 연결 매개 변수를 변경할 수 있으므로 권장되는 방법입니다. 흐름이 솔루션에 없는 경우 복사/붙여넣기에 편리한 문자열을 유지합니다.

일반 제한

이름	가치
동적 스키마에서 지원하는 최대 속성 수입니다. JSON 구문 분석 작업을 사용하여 최대 속성 수를 초과하는 경우 샘플 페이로드에서 스키마를 생성할 수 있습니다.	1024

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.


Microsoft Entra ID(인증서 포함)	X509 인증서를 통해 Microsoft Entra ID 보안 주체 전파를 사용하여 SAP에 액세스합니다.	모든 지역	공유할 수 없음
Microsoft Entra ID(Kerberos 포함)	Kerberos를 통해 Microsoft Entra ID 보안 주체 전파를 사용하여 SAP에 액세스합니다.	모든 지역	공유할 수 없음
SAP 인증	SAP 사용자 이름 및 암호를 사용하여 SAP 서버에 액세스합니다.	모든 지역	공유할 수 없음
Windows 인증	WINDOWS 사용자 이름 및 암호를 사용하여 SAP Server에 액세스합니다.	모든 지역	공유할 수 없음
기본값 [사용되지 않음]	이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.	모든 지역	공유할 수 없음