Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요. info
이전 Edge for Private Cloud 기능 출시 이후 다음 출시가 진행되었으며 이 기능 출시에 포함되어 있습니다.
| Edge UI 출시 | 에지 관리 출시 |
|---|---|
특정 클라우드 출시가 프라이빗 클라우드용 Edge 버전에 포함되어 있는지 확인하는 방법을 알아보려면 출시 번호 지정 정보를 참고하세요.
출시 개요
이 버전의 가장 중요한 새로운 기능은 Edge, API BaaS, 개발자 서비스 포털의 인증 메커니즘으로 보안 보장 마크업 언어 (SAML) 2.0 지원이 추가된 것입니다. SAML을 Edge와 함께 사용하면 SAML을 지원하는 다른 서비스 외에도 Edge UI 및 API에 대해 SSO를 지원할 수 있습니다.
SAML 인증은 여러 이점을 제공합니다. SAML을 사용하면 다음을 수행할 수 있습니다.
- 사용자 관리를 완전히 제어합니다. 사용자가 조직을 떠나고 중앙에서 프로비저닝이 해제되면 해당 사용자의 Edge 액세스가 자동으로 거부됩니다.
- 사용자가 Edge에 액세스하기 위해 인증하는 방식을 관리합니다. Edge 조직마다 다른 인증 유형을 선택할 수 있습니다.
- 인증 정책을 제어합니다. SAML 제공업체가 기업 표준에 부합하는 인증 정책을 지원할 수 있습니다.
- Edge 배포에서 로그인, 로그아웃, 로그인 시도 실패, 고위험 활동을 모니터링할 수 있습니다.
- SAML은 인증에만 사용됩니다. 승인은 Edge 사용자 역할에 의해 계속 관리됩니다.
자세한 내용은 프라이빗 클라우드용 Edge에서 SAML 지원을 참고하세요.
이 출시에는 다음과 같은 여러 가지 주목할 만한 기능이 포함되어 있습니다.
- Apache/MySQL에서 Postgres/Nginx로 Developer Services Portal을 이전하는 기능
- Edge UI에서 TLS를 사용 중지하는 명령어
- Edge 설치를 구성하는 새로운 속성
- 맞춤 고객 키 및 보안 비밀 이름 지정 규칙
- Red Hat/CentOS 버전 7.4 지원
이 주제의 나머지 부분에는 이번 출시에 포함된 모든 새로운 기능, 업데이트, 버그 수정에 관한 세부정보가 포함되어 있습니다.
지원 중단 및 중단
이번 출시에서 지원 중단되거나 사용 중지된 기능은 다음과 같습니다. 자세한 내용은 Edge 지원 중단 정책을 참고하세요.
지원 중단
Apigee 보안 저장소 (보관소) 지원 중단
'보관소'라고도 하는 Apigee 보안 저장소가 지원 중단되며 2018년 4월에 폐쇄될 예정입니다. 키-값 쌍의 암호화된 스토리지를 제공하는 볼트는 관리 API로 생성되며 apigee-access Node.js 모듈의 함수를 사용하여 런타임에 액세스합니다.
보안 저장소를 사용하는 대신 키-값 맵 사용에 설명된 대로 암호화된 키-값 맵 (KVM)을 사용하세요. 암호화된 KVM은 보관소만큼 안전하며 생성 및 검색을 위한 더 많은 옵션을 제공합니다. (MGMT-3848)
API 프록시 성능 탭에서 경로 추가 지원 중단
이 출시 이전에는 관리 UI에서 API 프록시로 이동하여 성능 탭으로 이동하고 프록시의 성능 탭과 비즈니스 트랜잭션 대시보드에서 차트 기반 비교를 위한 다양한 경로를 만들 수 있었습니다. 이 기능은 지원 중단되었으며 더 이상 UI에서 사용할 수 없습니다. 이 기능의 대안은 다음 Apigee 커뮤니티 도움말을 참고하세요. 비즈니스 트랜잭션 API의 대안 (EDGEUI-902)
새로운 기능 및 업데이트
이번 출시 버전의 새로운 기능과 향상된 기능은 다음과 같습니다. 다음 개선사항 외에도 이번 출시에는 사용성, 성능, 보안, 안정성 개선사항이 여러 개 포함되어 있습니다.
프라이빗 클라우드
Edge, API BaaS, 개발자 서비스 포털에 SAML 지원 추가
이제 Edge는 Edge, API BaaS, 개발자 서비스 포털의 인증 메커니즘으로 보안 보장 마크업 언어 (SAML) 2.0을 지원합니다. SAML은 싱글 사인온(SSO) 환경을 지원합니다. SAML을 사용하면 SAML을 지원하는 다른 서비스 외에도 Edge에 대해 SSO를 지원할 수 있습니다.
Private Cloud용 Edge에서 SAML 지원을 참고하세요.
apigee-ssoadminapi.sh 유틸리티 추가
SAML을 사용 설정한 후에는 이제 새 apigee-ssoadminapi.sh를 사용하여 사용자 및 조직 만들기 등 다양한 관리 작업을 실행합니다.
apigee-ssoadminapi.sh 사용을 참고하세요.
(DOS-5118)
이제 Apache/MySQL/MariaDB에서 Nginx/postgres로 개발자 서비스 포털을 마이그레이션할 수 있음
개발자 서비스 포털의 .tar 기반 설치는 Apache 및 MySQL 또는 MariaDB를 사용합니다. 이제 기존 포털 설치를 마이그레이션하여 Nginx와 Postgres를 사용할 수 있습니다. 포털 버전 4.17.09로 업데이트하려면 이 이전이 필요합니다.
tar 기반 포털을 RPM 기반 포털로 변환을 참고하세요.
Red Hat/CentOS 버전 7.4 지원 추가
이제 Red Hat/CentOS 버전 7.4에 프라이빗 클라우드용 Edge, API BaaS, 개발자 서비스 포털을 배포할 수 있습니다.
지원되는 소프트웨어 및 지원되는 버전을 참고하세요.
설치 중에 설치 프로그램이 CPU 및 메모리 요구사항을 확인하도록 하는 속성 추가
이제 Edge 설치 구성 파일에서 다음 속성을 지원합니다.
ENABLE_SYSTEM_CHECK=y 'y'인 경우 설치 프로그램은 시스템이 설치되는 구성요소의 CPU 및 메모리 요구사항을 충족하는지 확인합니다. 각 구성요소의 요구사항은 설치 요구사항을 참고하세요. 기본값은 검사를 사용 중지하는 'n'입니다.
Edge 구성 파일 참조를 참고하세요.
(DOS-4772)
서버에 인터페이스 카드가 여러 개 있는 경우 설치 프로그램에서 사용하는 IP 주소를 선택할 수 있는 속성 추가
서버에 인터페이스 카드가 여러 개 있는 경우 'hostname -i' 명령어가 공백으로 구분된 IP 주소 목록을 반환합니다. 기본적으로 Edge 설치 프로그램은 반환된 첫 번째 IP 주소를 사용하며, 이는 모든 상황에서 올바르지 않을 수 있습니다. 또는 설치 구성 파일에서 다음 속성을 설정할 수 있습니다.
ENABLE_DYNAMIC_HOSTIP=y
이 속성을 'y'로 설정하면 설치 프로그램에서 설치의 일부로 사용할 IP 주소를 선택하라는 메시지가 표시됩니다. 기본값은 'n'입니다.
Edge 구성 파일 참조를 참고하세요.
(DOS-5117)
TLS 구성에 사용할 수 있는 새로운 UI 옵션 및 API
이제 클라우드의 새로운 셀프 서비스 TLS/SSL 기능의 베타 버전이 비공개 클라우드에서 베타 기능으로 제공됩니다. 이 베타를 사용하면 다음 작업을 할 수 있습니다.
- UI 및 API에서 키 저장소와 신뢰 저장소 생성, 수정, 삭제
- TLS 인증서를 PKCS12/PFX로 업로드
- UI 또는 API에서 자체 서명 인증서 생성
- UI에서 키 저장소 또는 트러스트 저장소의 유효성 테스트
이러한 기능의 베타 문서 (PDF)는 다음에서 확인할 수 있습니다.
자세한 내용은 추가 문서 (PDF)를 참고하세요.
(EDGEUI-1058)
난독화된 비밀번호 명령어 추가
구성요소가 암호화된 비밀번호를 생성할 수 있도록 난독화된 비밀번호를 생성하는 명령어를 추가했습니다. Edge 관리 서버에서 다음 명령어를 사용하여 난독화된 비밀번호를 생성할 수 있습니다.
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password
새 비밀번호를 입력한 다음 메시지가 표시되면 확인합니다. 보안상의 이유로 비밀번호 텍스트는 표시되지 않습니다. 이 명령어는 다음 형식으로 비밀번호를 반환합니다.
OBF:58fh40h61svy156789gk1saj MD5:902fobg9d80e6043b394cb2314e9c6
Edge 온프레미스용 TLS/SSL 구성을 참고하세요.
(TBD-250)
조직 사용자의 비밀번호를 변경할 때 새 비밀번호를 난독화하는 새 명령어 추가
이제 조직 사용자의 비밀번호를 재설정하려면 apigee-service 유틸리티를 사용하여 apigee-openldap을 호출합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail
시스템 관리자의 비밀번호와 새 사용자 비밀번호를 입력하라는 메시지가 표시됩니다. 보안상의 이유로 비밀번호를 입력할 때 비밀번호 텍스트가 표시되지 않습니다.
Edge 비밀번호 재설정을 참고하세요.
(DBS-1733)
Edge UI에서 TLS를 사용 중지하는 명령어 추가
이제 다음 명령어를 사용하여 Edge UI에서 TLS를 사용 중지할 수 있습니다.
/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl
관리 UI용 TLS 구성을 참고하세요.
(EDGEUI-1114)
로그 메시지의 타임스탬프 형식을 제어하는 속성 추가
기본적으로 메시지 로깅 정책으로 생성된 로그 메시지의 타임스탬프는 다음 형식을 갖습니다.
yyyy-MM-dd'T'HH:mm:ss.sssZ
예를 들면 다음과 같습니다.
2017-05-08T13:33:00.000+0000
Edge 메시지 프로세서의 conf_system_apigee.syslogger.dateFormat 속성을 사용하여 형식을 제어할 수 있습니다.
메시지 로깅 정책을 참조하세요.
(APIRT-4196)
API BaaS 설치에 필수 SMTP 구성 매개변수 추가
이제 API BaaS 설치 구성 파일에서 SMTPMAILFROM 매개변수를 사용해야 합니다. 이 매개변수는 사용자가 비밀번호 재설정을 요청하는 경우와 같이 API BaaS가 자동 이메일을 전송할 때 사용되는 이메일 주소를 지정합니다.
BaaS 구성 파일 참조를 참고하세요.
(APIBAAS-2103)
포털의 Edge 라우터와 Nginx 웹 서버가 1000 미만의 포트에 액세스할 수 있도록 지원 추가
이제 포털의 라우터와 Nginx 웹 서버를 다른 사용자로 실행하지 않고도 1000 미만의 포트에 액세스할 수 있습니다. 이전 버전에서는 라우터와 Nginx 웹 서버를 특수 사용자로 실행하지 않으면 1000 미만의 포트에 액세스할 수 없었습니다.
Edge UI의 로깅 수준을 구성하는 방법이 변경됨
Edge UI의 로깅 수준을 구성하는 데 사용되는 속성이 변경되었습니다. 새 속성 및 절차는 Edge 구성요소의 로그 수준 설정을 참고하세요.
(EDGEUI-886)
API 서비스
맞춤 고객 키 및 보안 비밀 이름 지정 규칙
개발자 앱의 맞춤 고객 키와 보안 비밀 만들기의 이름 지정 규칙과 유효성 검사가 업데이트되었습니다. 고객 키와 보안 비밀에는 문자, 숫자, 밑줄, 하이픈이 포함될 수 있습니다. 다른 특수문자는 허용되지 않습니다.
맞춤 키/보안 비밀 생성 프로세스는 기존 고객 키 및 보안 비밀 가져오기에 자세히 설명되어 있습니다. (MGMT-3916)
키 저장소 및 대상 서버 이름 유효성 검사
키 저장소 및 타겟 서버의 이름은 최대 255자이며 문자, 숫자, 공백, 하이픈, 밑줄, 마침표를 포함할 수 있습니다. 이제 Edge에서 생성 시 이를 검증합니다. (MGMT-4098)
수정된 버그
다음은 이번 출시 버전에서 수정된 버그입니다. 이 목록은 주로 자신의 지원 티켓에서 제기한 문제가 수정되었는지 확인하는 사용자를 위한 것입니다. 모든 사용자에게 자세한 정보를 제공하기 위한 목적은 아닙니다.
프라이빗 클라우드 4.17.09
| 문제 ID | 설명 |
|---|---|
| APIRT-4346 |
이제 FIPS 지원 서버에서 Edge 라우터가 작동함 이제 Edge 라우터를 FIPS (연방 정보 처리 표준)를 지원하는 서버에 배포할 수 있습니다. |
| APIRT-4726 |
ScriptableHttpClient는 전송 시 메시지 컨텍스트가 여전히 있다고 가정해서는 안 됨 이제 ScriptableHttpClient가 시작 시간에 메시지 컨텍스트를 읽습니다. |
|
DBS-1529 |
Cassandra 백업 스크립트가 더 이상 Cassandra를 중지/다시 시작하지 않음 이전에는 Cassandra 백업 스크립트가 백업 프로세스의 일부로 Cassandra 서버를 중지한 후 다시 시작했습니다. 스크립트가 더 이상 이 중지/다시 시작을 실행하지 않으며 백업 프로세스 중에 Cassandra 서버가 실행된 상태로 유지됩니다. |
| DOS-5100 |
이제 설치 프로그램이 PG_PWD에 지정된 값을 기반으로 Postgres 비밀번호를 설정함 이전 버전에서는 구성 파일의 PG_PWD 값을 기반으로 Postgres 비밀번호가 올바르게 설정되지 않았습니다. |
| EDGESERV-7 |
Node.js 기본 속성 업데이트 이제 Node.js는 비공개 클라우드 설치의 속성에 다음 기본값을 사용합니다. connect.ranges.denied= connect.ranges.allowed= connect.ports.allowed= 즉, Edge for Private Cloud는 더 이상 기본적으로 Node.js 코드가 특정 IP 주소에 액세스하는 것을 제한하지 않습니다. 자세한 내용은 Node.js 모듈에 대한 Edge 지원 이해하기를 참고하세요. |
| EDGEUI-1110 |
OpenAPI를 사용하여 프록시를 만들 때 리소스 이름을 볼 수 없음 이제 OpenAPI를 사용하여 프록시를 만들 때 리소스 이름이 올바르게 표시됩니다. |
| MGMT-4021 |
이제 관리 서버 업 API 호출이 올바르게 포맷된 응답을 반환함 이제 /v1/servers/self/up API 호출이 항상 텍스트를 반환하는 대신 올바르게 형식이 지정된 xml 또는 json을 반환합니다. |
| MGMT-4294 |
공백이나 하이픈이 포함된 프록시 및 제품 이름으로 인해 권한 문제가 발생함 이제 이름에 공백이나 하이픈이 포함된 경우 프록시 및 제품 이름이 올바르게 작동합니다. |
Cloud 17.08.16 (UI)
| 문제 ID | 설명 |
|---|---|
| 64530444 | API 프록시 편집기에서 YAML 파일을 수정 가능으로 처리 이제 API 프록시 편집기를 사용하여 YAML 파일을 수정할 수 있습니다. 이제 편집기에서 YAML 파일을 열어도 오류 메시지가 표시되지 않습니다. |
| 64479253 | 추적 탭에서 로그 수정 버튼 사용 설정 Node.js 로그 버튼은 API 프록시에 Node 소스 파일이 있는 경우에만 추적 페이지에 표시됩니다. |
| 64441949 | GeoMap 분석 대시보드의 다운로드 문제 수정 GeoMap 분석 대시보드에서 CSV 파일이 다운로드되지 않는 문제가 수정되었습니다. |
| 64122687 | operationID가 없는 OpenAPI 사양은 이름이 'undefined'인 흐름을 생성합니다. 이제 operationID가 정의되지 않은 OpenAPI 사양에서 API 프록시를 생성할 때 경로와 동사가 조건부 흐름 이름에 사용됩니다. |
클라우드 17.08.14 (API 관리 및 런타임)
| 문제 ID | 설명 |
|---|---|
| APIRT-4584 | 흐름 후크가 일관되게 배포되지 않고 ZooKeeper 확인이 작동하지 않음 |
| APIRT-3081 | 동시 비율 한도 정책으로 인한 messaging.adaptors.http.flow.ServiceUnavailable 오류 |
Cloud 17.07.31 (API 관리)
| 문제 ID | 설명 |
|---|---|
| MGMT-4141 |
비공개 접두사로 검색해도 KVM의 암호화된 값이 복호화되지 않음
|
Cloud 17.07.17 (API 관리 및 런타임)
| 문제 ID | 설명 |
|---|---|
| APIRT-4400 | nginx 응답에 'Apigee 라우터'가 표시됨 |
| APIRT-4155 | ExtractVariables 정책이 POST 본문에서 형식이 잘못된 양식 매개변수를 처리하지 않음 |
| APIRT-3954 |
HTTP 상태 확인은 초당 한 번 이상 실행하면 안 됩니다.
이 수정사항은 많은 수의 상태 점검으로 인해 성능이 저하되는 문제를 해결합니다. |
| APIRT-3928 | 요청에서 반환된 메시지에 'nginx'가 포함됨 |
| APIRT-3729 | AssignMessage 정책이 x-forwarded-for 헤더를 삭제한 후 Apigee가 proxy.client.ip 변수를 수정함 |
| APIRT-3546 | AssignMessage 정책을 사용하여 새 메시지를 만들 때 추적에 새 메시지가 할당되었다고 표시되지 않음 |
| APIRT-1873 | 구성된 트러스트 저장소가 없는 경우 다운스트림 SSL이 JDK 트러스트 저장소로 대체되면 안 됨 |
| APIRT-1871 | 하향 : 인증서 일반 이름이 URL의 호스트 이름과 비교하여 검증되지 않음 |
Cloud 2020년 6월 17일 (UI)
| 문제 ID | 설명 |
|---|---|
| EDGEUI-1087 | 셀프 서비스 TLS UI에서 체인 인증서 경고 메시지 삭제 인증서 체인 경고 표시가 UI에서 삭제되었습니다. 인증서 체인이 포함된 별칭 행에는 이제 만료일이 가장 가까운 인증서의 데이터가 '만료일' 및 '일반 이름' 열에 표시됩니다. 별칭 패널의 인증서 선택기 아래에 있는 경고 배너가 정보 주석으로 변경되었습니다. |
Cloud 17.06.14 (UI)
| 문제 ID | 설명 |
|---|---|
| EDGEUI-1092 | 키 저장소 별칭 패널의 작업이 작동하지 않음 새 TLS 키 저장소 UI의 베타 버전에서 별칭 패널을 볼 때 작업 버튼이 항상 작동하지는 않았습니다. 이 문제는 해결되었습니다. |
| EDGEUI-1091 | 별칭 인증서를 업데이트한 후 별칭 패널이 깨짐 새 TLS 키 저장소 UI의 베타 버전에서 별칭 인증서를 업데이트한 후 별칭 패널에 오류가 발생하여 별칭 세부정보를 표시하기 위해 새로고침해야 하는 경우가 있었습니다. 이 문제는 해결되었습니다. |
| EDGEUI-1088 | 사용자 설정 페이지에서 수정 버튼을 클릭하면 404 오류가 발생함 이제 사용자 계정 설정을 수정하면 2단계 인증 구성 페이지로 이동합니다. 자세한 내용은 Apigee 계정에 2단계 인증 사용 설정하기를 참고하세요. 비밀번호를 업데이트하려면 계정에서 로그아웃하고 로그인 페이지에서 비밀번호 재설정을 클릭해야 합니다. |
| EDGEUI-1082 | 키 저장소 목록에서 * 선택기를 처리하지 않음 와일드카드 선택기가 키 저장소 목록 필터링 입력에서 작동하지 않았습니다. 이 문제는 해결되었습니다. |
| EDGEUI-1079 | CPS 조직의 개발자 세부정보에서 키 필드 숨기기 CPS 조직의 경우 키 필드가 개발자 세부정보 페이지에 표시되지 않습니다. |
| EDGEUI-1074 | 연결된 인증서를 볼 때 인증서 유효성 아이콘이 헤드 인증서만 나타냄 인증서 유효성 아이콘이 항상 헤드 인증서를 나타내는 대신 현재 선택된 인증서를 나타냅니다. |
| UAP-328 | 모든 API 프록시를 표시하는 지연 시간 분석 필터 드롭다운 이전에는 특정 상황에서 프록시 필터 드롭다운에서 API 프록시가 삭제되었지만 이제는 더 이상 삭제되지 않습니다. 선택한 시간 간격에 데이터가 없는 API 프록시를 선택하면 이제 No data to show가 표시됩니다. |
Cloud 17.05.22.01 (수익 창출)
| 문제 ID | 설명 |
| DEVRT-3647 |
거래 상태 API 사용성 개선
거래 상태 보기에 설명된 거래 상태 API가 다음과 같이 개선되었습니다.
또한 거래 상태 API 문제가 해결되었습니다. |
Cloud 2022년 5월 17일 (UI)
| 문제 ID | 설명 |
|---|---|
| EDGEUI-1027 |
키 저장소/신뢰 저장소 별칭 패널에 인증서 체인의 각 인증서에 대한 세부정보가 표시되어야 함 별칭에 인증서 체인을 업로드하면 이제 별칭 패널을 볼 때 드롭다운에서 각 인증서를 선택하여 세부정보를 볼 수 있습니다.
참고: 인증서 체인은 권장사항이 아닙니다. Apigee에서는 각 인증서를 별도의 별칭에 저장하는 것이 좋습니다. |
| EDGEUI-1003 | CPS 고객에게 개발자 앱 전체 목록 표시 이제 CPS 고객이 개발자 세부정보를 볼 때 개발자 앱의 전체 목록을 볼 수 있습니다. 이전 버전에서는 볼 수 있는 개발자 앱의 최대 개수가 100개였습니다. |
Cloud 2022년 5월 17일 (API 관리)
| 문제 ID | 설명 |
|---|---|
| MGMT-4059 | |
| MGMT-3517 | 프록시 배포 오류 메시지의 프록시 버전이 잘못됨 |
Cloud 17.05.08 (UI)
| 문제 ID | 설명 |
|---|---|
| EDGEUI-1041 |
부적절한 인코딩으로 인해 확장 ASCII 문자가 포함된 엔티티 업데이트가 실패함 |
| EDGEUI-1033 |
Edge UI에 403 오류에 대해 '세션 시간 초과'가 표시됨 |
| EDGEUI-1019 |
Edge UI가 시간 초과되면 알 수 없는 오류 메시지가 표시됨 |
Cloud 2022년 4월 17일 (API 관리)
| 문제 ID | 설명 |
|---|---|
| MGMT-3977 | 사용자 권한과 관련된 보안 수정이 이루어졌습니다. |
알려진 문제
이 출시에는 다음과 같은 알려진 문제가 있습니다.
| 문제 ID | 설명 |
|---|---|
| 67169830 | 응답 캐시의 NullPointerException 이전 버전에서 캐시된 객체가 캐시에서 올바르게 복구되지 않을 수 있습니다. |