Changepoint API 소프트웨어 설치 가이드

API 설치 가이드
참조 가이드
2021년 변화점

© 2021 Changepoint Canada ULC 판권 소유. 미국 정부의 권리-미국 정부에 의한 사용, 복제 또는 공개는 Changepoint Canada ULC 라이선스 계약과 DFARS 227.7202-1(a) 및 227.7202-3(a)(1995)에 규정된 제한 사항의 적용을 받습니다. DFARS 252.227-7013(c)(1)(ii)(OCT 1988), FAR 12.212(a)(1995), FAR 52.227-19 또는 FAR 52.227-14(ALT III)를 적용할 수 있습니다. 이 제품에는 Changepoint Canada ULC의 기밀 정보 및 영업 비밀이 포함되어 있습니다. Changepoint Canada ULC의 명시적인 사전 서면 승인 없이는 공개가 금지됩니다. 이 제품의 사용에는 Changepoint Canada ULC와의 사용자 라이센스 계약 조건이 적용됩니다. 문서는 라이센스 사용자가 내부용으로만 복제할 수 있습니다. Changepoint Canada ULC의 명시적인 서면 동의 없이 이 문서의 내용을 변경, 수정 또는 변경할 수 없습니다. Changepoint Canada ULC는 통지 여부에 관계없이 언제든지 여기에 지정된 내용을 변경할 수 있습니다.

내용물 숨다

1 Changepoint API 설치

2 COM API 연결 테스트

3 테스트 중 Web 서비스 API 연결

4 문서 / 리소스

4.1 참고문헌

5 관련 게시물

Changepoint API 설치

Changepoint API 설치 정보
Changepoint API는 COM API, WCF(Windows Communication Foundation) 서비스로 사용할 수 있으며 이전 버전과의 호환성을 위해 Web 서비스 향상(WSE) 서비스. Changepoint API에 대한 자세한 내용은 Changepoint API 참조를 참조하십시오. 업그레이드 정보, 주의 사항 및 알려진 문제에 대해서는 Changepoint의 팀 폴더에 있는 릴리스 정보를 참조하십시오.
Changepoint API 업그레이드
Changepoint의 이전 릴리스에서 업그레이드하는 경우 이 버전을 설치하기 전에 Windows 제어판을 사용하여 이전 버전의 Changepoint API 및 해당 구성 요소를 제거하십시오.
Changepoint API 요구 사항
Changepoint API를 설치하기 전에 Changepoint를 설치해야 합니다. 소프트웨어 요구 사항은 Changepoint의 2021 릴리스 정보 및 패치 팀 폴더에 있는 Changepoint 소프트웨어 호환성 매트릭스를 참조하십시오.
File 경로 규칙
이 문서 전체에서 다음과 같은 규칙이 공통 경로에 사용됩니다.

Changepoint 설치의 루트 경로입니다.
기본 경로는 다음과 같습니다.
C:프로그램 Files (x86)변경점변경점

로그인 설정 유틸리티와 같은 일반적인 Changepoint 유틸리티의 루트 위치입니다.
기본 경로는 다음과 같습니다.
C:프로그램 Files (x86)공통 FilesChangepointChangepoint

Changepoint API 설치

Changepoint API 미디어 루트 디렉터리에서 setup.exe를 실행합니다.
기능 선택 화면이 나타날 때까지 지시를 따릅니다.
설치할 기능을 선택한 후 다음을 클릭하십시오.

API 대상 폴더 선택, 기본값 API를 선택하고 다음을 클릭합니다.
메모: Changepoint 로그인 설정 유틸리티는 다음에 설치됩니다. 지정한 대상 폴더에 관계없이 LoginSettings.
선택한 경우 Web 서비스 API: 선택 시
a Web 사이트 화면이 나타나면 web가상 디렉터리를 추가할 사이트를 클릭하고 다음을 클릭합니다.
비. 계속하려면 다음을 클릭하십시오. 6. API 설치가 완료되면 마침을 클릭합니다.

캐시를 인식하도록 Changepoint API 구성
캐시를 인식하도록 Changepoint API를 구성하려면 "cache.xml"의 값을 바꾸십시오. 암호” 및 “캐시. CP의 서버” 키 Web 서비스Web.구성 file 엔터프라이즈에서 사용되는 값으로Web.구성 file.
활성화 Web 서비스 향상(WSE)

편집하다 Web.구성 file ~을 위한 web 서비스. 기본 위치는 다음과 같습니다.
APICP Web 서비스Web.구성

다음 주석 행의 세 가지 인스턴스를 찾으십시오.
< !– 사용 중인 경우 다음 요소의 주석 처리를 제거하십시오. Web 서비스 향상(WSE) API. WCF 서비스를 사용 중이고 설치하지 않는 경우 댓글을 남겨주세요. Web 서비스 향상(WSE) –>
주석 행의 각 인스턴스 뒤에 오는 요소의 주석을 제거하십시오.
<section name=”microsoft.web.서비스2″ … >web서비스>web.서비스2>
메모: 그만큼web주석을 제거할 Services> 요소는 다음의 하위 항목입니다.web>.

다음에 대한 로깅 구성 Web 서비스 API
로그를 설정해야 합니다. file 경로 및 로그 수준. 로그 수준은 누적됩니다. 예를 들어amp파일에서 수준 3을 지정하면 수준 1, 2, 3이 기록됩니다. 기본 로그 수준은 8입니다.

편집하다 web 서비스 Web.config. 기본 위치는 다음과 같습니다.
APICP Web 서비스Web.구성

로그 설정File길. 기본값은 APIAPI로그. 3. LogLevel을 설정합니다. 유효한 값은 다음과 같습니다.
0 = 로깅 없음
1 = 소스 개체 및 메서드
2 = 오류 메시지
3 = 입력 매개변수
4 = 반품
5 = 경고
8 = 체크포인트

다음에 대한 가상 디렉터리 인증 구성 Web 서비스 API
CP에 대해 익명 액세스를 활성화하고 Windows 통합 인증을 비활성화해야 합니다.Web인터넷 정보 서비스(IIS)의 서비스 가상 디렉터리. 자세한 내용은 Microsoft IIS 설명서를 참조하십시오.
에 대한 데이터베이스 연결 설정 구성 Web 서비스 API
로그인 설정 유틸리티를 사용하여 데이터베이스 연결 설정을 암호화합니다. Web 서비스 API Web.구성 file. 자세한 내용은 Changepoint 설치 안내서에서 "데이터베이스 연결 설정 구성"을 검색하십시오.
Changepoint WCF에 대한 인증 구성 Web 서비스
Changepoint WCF에 대해 애플리케이션 인증 및 SSO(Single Sign-On)를 구성할 수 있습니다. Web 서비스
STS(Secure Token Service)를 사용하여 다음 구현 옵션을 사용할 수 있습니다.

ISAPI SSL을 사용하는 SSO 선택 사항
WS-Federation(ADFS 2.0) SSL을 사용하는 SSO 필요

SSL이 필요한 경우 구성 스크립트는 SSL이 사용되는지 확인합니다.
ISAPI 및 응용 프로그램 인증을 위한 구성 스크립트는 선택적으로 SSL을 활성화할 수 있습니다.
WCF에 대한 애플리케이션 인증 구성 Web 서비스
Changepoint WCF의 기본 인증 유형 Web 서비스는 애플리케이션 인증입니다.
이 섹션의 절차를 사용하여 다음을 수행합니다.

Changepoint WCF 구성 Web SSL로 애플리케이션 인증을 사용하는 서비스

변경 지점 WCF 되돌리기 Web SSO 구현 중 하나를 구현한 후 애플리케이션 인증에 대한 서비스

PowerShell 구성

Windows PowerShell 프롬프트를 엽니다.
실행 정책을 수정합니다.
실행 정책 설정 제한 없음

Stage 1 구성 매개변수 수집
구성 매개변수의 값을 판별하십시오.

매개변수	설명
Web서비스_경로	Changepoint WCF의 위치 Web 서비스 web 애플리케이션 files. 기본: \API\CP Web 서비스
서비스 인증서_ 이름	메시지 보안 모드를 사용하여 클라이언트에 서비스를 인증하는 데 사용할 인증서 이름입니다. 기본값: "CN=ChangepointAPICertificate" 인증서 이름.
HTTPS 필요	HTTPS 필요(참/거짓) 기본값: 거짓.

Stage 2 구성 스크립트 실행
구성 매개변수의 값을 사용하여 구성을 수정합니다. web사이트.

PowerShell 프롬프트를 엽니다.
메모: 서버에 사용자 계정 컨트롤이 활성화되어 있는 경우 상승된 관리자 권한을 사용하여 PowerShell 프롬프트를 열어야 합니다.

CP로 이동 web 서비스 구성 디렉토리, 기본값:
구성CPWeb서비스
./Configuration_AppAuth.ps1 실행
메시지를 따르세요.

WCF용 SSO(Single Sign-On) 구성 Web 서비스
PowerShell 구성

Windows PowerShell 프롬프트를 엽니다.
실행 정책을 수정합니다.
실행 정책 설정 제한 없음

WCF용 ISAPI를 사용하여 SSO 구성 Web 서비스
Stage 1 구성 매개변수 수집
다음 구성 매개변수의 값을 결정하십시오.

매개변수	설명
Web서비스_경로	Changepoint WCF의 위치 Web 서비스 web 애플리케이션 files. 기본: \API\CP Web 서비스
HTTPS 필요	HTTPS(참/거짓)가 필요합니다. 기본값: 거짓.
변경점_RSA_ 쿠키_변환	쿠키 암호화에 사용하는 인증서의 이름입니다. 기본값: "CN=ChangepointAPICertificate" 인증서 이름.
서비스 인증서_이름	메시지 보안 모드를 사용하여 클라이언트에 서비스를 인증하는 데 사용할 인증서 이름을 입력합니다. 기본값: "CN=ChangepointAPICertificate" 인증서 이름.
서명 인증서_이름	서명 인증서 이름을 입력합니다. 메시지 서명에 사용하는 인증서의 이름입니다. 기본값: "CN=ChangepointAPICertificate" 인증서 이름.
ISAPI_모드	ISAPI 모드. 기본값: NT
ISAPI_헤더	ISAPI_Mode가 "HEADER"일 때 사용되는 헤더(예:amp르, 공백.
클레임 유형	SSO 클레임 유형을 입력합니다. 기본: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 구성 스크립트 실행

PowerShell 프롬프트를 엽니다.
메모: 서버에 사용자 계정 컨트롤이 활성화되어 있는 경우 상승된 관리자 권한을 사용하여 PowerShell 프롬프트를 열어야 합니다.

CP로 이동 web 서비스 구성 디렉토리, 기본값:
구성CPWeb서비스
실행: ./Configuration_SSO_ISAPI.ps1
메시지를 따르세요.

WCF용 WS-페더레이션(ADFS 2.0)을 사용하여 SSO 구성 Web 서비스
Stage 1 구성 매개변수 수집
아래 표에서 구성 매개변수의 값을 결정하십시오. ADFS_Server_URI가 최종 사용자 브라우저의 인트라넷 영역에 있는지 확인합니다.
메모: 기본적으로 Changepoint는 게시된 페더레이션 메타데이터 문서를 사용하여 보안 토큰 서명에 사용되는 공개 키를 자동으로 업데이트하도록 구성됩니다. ADFS에서 이것은 다음과 같습니다.
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
경우에 따라 Changepoint에서 ADFS 서버에 도달하지 못할 수 있습니다. web 구성 스크립트를 실행한 후 수동으로 구성을 업데이트해야 합니다. 자세한 내용은 12페이지의 "수동으로 공개 키 업데이트"를 참조하십시오.

매개변수	설명
Web서비스_경로	Changepoint WCF의 위치 Web 서비스 web 애플리케이션 file에스. 기본: \API\CP Web 서비스
Web서비스_URI	Changepoint WCF에 사용하는 도메인 식별자 Web 서비스. 예를 들어amp르., https://changepointapi.abc.corp/CPWebService
Changepoint_RSA_ Cookie_Transform	쿠키 암호화에 사용하는 인증서의 이름입니다. 기본값: "CN=ChangepointApiCertificate" 인증서 이름.
서비스 인증서_이름	메시지 보안 모드를 사용하여 클라이언트에 서비스를 인증하는 데 사용할 인증서 이름입니다. 기본값: "CN=ChangepointApiCertificate" 인증서 이름.
서명 인증서_이름	메시지 서명에 사용하는 인증서의 이름입니다. 기본값: "CN=ChangepointApiCertificate" 인증서 이름이 사용됩니다.
ADFS_FederationServiceName	페더레이션 서비스 이름. 이름을 얻으려면 ADFS 서버에서 ADFS 2.0 관리 콘솔을 시작합니다. •왼쪽 메뉴에서 ADFS 2.0을 선택합니다. • 작업 창에서 페더레이션 서비스 속성 편집을 선택합니다. 페더레이션 서비스 이름은 일반 탭에 있습니다.
클레임 유형	SSO 클레임 유형. 기본값은 다음과 같습니다. http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 구성 스크립트 실행
구성 web구성 매개변수 값을 사용하는 사이트.

PowerShell 프롬프트를 엽니다.
메모: 서버에 사용자 계정 컨트롤이 활성화되어 있는 경우 상승된 관리자 권한을 사용하여 PowerShell 프롬프트를 열어야 합니다.

변경 지점으로 이동 web 서비스 구성 디렉토리, 기본값: 구성CPWeb서비스
실행: ./Configuration_SSO_ADFS.ps1
메시지를 따르세요.

Stage 3 신뢰 당사자 트러스트 생성
ADFS 2.0 콘솔에서 신뢰 당사자 트러스트를 만듭니다.

ADFS 서버에서 ADFS 2.0 콘솔을 시작합니다.
작업 > 신뢰 당사자 트러스트 추가를 선택합니다.
시작을 클릭하세요.
온라인 또는 로컬 네트워크에 게시된 신뢰 당사자에 대한 데이터 가져오기를 선택합니다.
페더레이션 메타데이터 주소를 입력하고 다음을 클릭합니다.amp르 :
https://changepointapi.abc.corp/cpwebservice/federationmetadata/2007-06/federationmetadata.xml
Changepoint WCF API와 같은 표시 이름을 입력하고 다음, 다음, 다음, 닫기를 차례로 클릭합니다.
위의 Changepoint Relying Party에 대한 클레임 규칙을 추가합니다. Changepoint의 경우 기본 클레임 규칙 이름은 "UPN"입니다.
LDAP 특성 "User-Principal-Name"을 발신 클레임 유형 "* UPN" 또는 "UPN"에 매핑합니다.

공개 키 수동 업데이트
ADFS 서버 토큰 서명 지문을 얻으려면

ADFS 서버에서 ADFS 2.0 관리 콘솔을 시작합니다.
서비스 > 인증서를 선택하고 토큰 서명 인증서를 두 번 클릭합니다.
세부정보 탭을 선택하세요.
지문 필드를 선택합니다.
지문 값을 얻으려면 첫 번째 공백을 포함하여 모든 공백을 제거하십시오.

업데이트하려면 Web.구성 file

ADFS 편집 web.config. 기본 위치는 다음과 같습니다.
EnterpriseRP-STS_ADFS
아래의 요소에서 ida:FederationMetadataLocation 키를 찾고 해당 값을 지웁니다.
아래에 , 찾기 요소를 다음으로 바꿉니다. https://ADFS_Federation.ServiceName/adfs/services/trust">https://ADFS_Federation.ServiceName/adfs/services/trust” />

COM API 연결 테스트

API 테스트 키트를 실행합니다. 기본 위치는 다음과 같습니다.
APIAPI 구성 요소ApiTestKit.exe.
연결 문자열 > 암호화기를 클릭합니다.
일반 텍스트 연결 문자열 필드에서:
ㅏ. SERVERNAME 및 DATABASENAME을 데이터베이스 정보로 바꿉니다.
비. USERID 및 PASSWORD를 데이터베이스 관리자 사용자 계정 정보로 바꿉니다.
씨. 필요에 따라 제한 시간 값을 입력하십시오.
암호화를 클릭합니다.
암호화된 연결 문자열 필드에서 텍스트를 복사합니다.
대화 상자를 닫습니다.
API 테스트 키트 메뉴에서 연결 > COM API 연결 테스터를 클릭합니다.
현재 버전 탭에서 암호화된 연결 문자열을 연결 문자열 필드에 붙여넣습니다.
LoginId 및 Password 필드에 Changepoint 계정의 로그인 ID와 암호를 입력하십시오.
로그 수준(0-8) 필드에서 COM API 로그에 반환할 오류 정보 수준을 지정합니다. file 테스트 결과 연결에 문제가 있는 경우.
0 = 로깅 없음
1 = 소스 개체 및 메서드
2 = 오류 메시지
3 = 입력 매개변수
4 = 반품
5 = 경고
8 = 체크포인트
기본값은 8입니다.
연결을 클릭하세요.
연결에 성공하면 결과 필드에 성공 메시지가 표시됩니다. 연결에 실패한 경우 COM API 로그를 확인하십시오. file 오류. 로그의 기본 위치 file ~이다 APIAPI로그.

설치된 API 구성 요소의 버전 확인
버전 검사기 유틸리티를 사용하여 릴리스 버전 및 경로를 포함하여 설치된 구성 요소에 대한 세부 정보를 얻을 수 있습니다.

CPVersionChecker.exe를 실행합니다. 기본 경로는 다음과 같습니다. APIAPI 구성 요소
읽기를 클릭합니다.

버전 확인 Web 서비스 API

해당 서버에서 Internet Explorer를 실행합니다. Web Services API가 설치되고 주소를 입력합니다.
http://localhost.port/CPWeb.Service/WSLogin.asmx 여기서 port는 포트 번호입니다. webCP를 설치한 사이트Web서비스 가상 디렉터리.
WSLogin 페이지에서 GetVersion 링크를 클릭하십시오.
호출을 클릭합니다.

테스트 중 Web 서비스 API 연결

해당 서버에서 Internet Explorer를 실행합니다. Web Services API가 설치되고 주소를 입력합니다. http://localhost.port/CPWeb.Service/WSLogin.asmx 여기서 port는 포트 번호입니다. webCP를 설치한 사이트Web서비스 가상 디렉터리.
WSLogin 페이지에서 TestConnection 링크를 클릭하십시오.
호출을 클릭합니다. 4. 테스트 결과에서:

만약에 요소가 거짓이면 테스트 연결이 성공했습니다.

만약에 요소가 true인 경우 테스트 연결에 실패했습니다. 이상
실패 이유에 대한 정보는 다음을 참조하십시오. 그리고 테스트 결과의 요소를 확인하고 API 로그를 확인합니다. API 로그의 기본 경로는 다음과 같습니다. APIAPI로그

설정하기 Web 언어 서버의 서비스 API

Changepoint를 배포하려면 Web 서비스 API를 언어 서버에 추가하거나 업데이트해야 합니다. tag 에서 Web 서비스 API web.config. 기본 위치는 Web.구성 file 이다: APICP Web 서비스Web.구성

만약 tag 이미 존재하는 경우 culture 및 uiCulture 속성이 모두 "en-US"인지 확인하십시오.
만약 tag 이미 존재하지 않는 경우 다음을 추가하십시오. , 댓글 및 에 대한 요소web> 노드:web>
Visual Basic 옵션: 데이터 손실이 발생할 수 있는 모든 데이터 유형 변환을 허용하지 않으려면 strict="true"로 설정하십시오. 모든 변수를 강제로 선언하려면 명시적=”true”로 설정합니다. –>
IIS를 다시 시작하십시오.