에지에서 기본 인증 사용 중지

Private Cloud용 Edge v4.18.01

Edge에서 SAML을 사용 설정한 후 기본 인증을 사용 중지할 수 있습니다. 하지만 기본 인증을 사용 중지하기 전에 다음 안내를 따르세요.

• 시스템 관리자를 포함한 모든 Edge 사용자를 SAML IDP에 추가했는지 확인합니다.
• Edge UI 및 Edge 관리 API에서 SAML 인증을 철저히 테스트해야 합니다.
• API BaaS도 사용하는 경우 API BaaS에서 SAML을 구성하고 테스트합니다. API BaaS에 SAML 사용 설정을 참조하세요.
• 개발자 서비스 포털을 사용하는 경우 포털에서 SAML을 구성하고 테스트하여 포털이 Edge에 연결될 수 있는지 확인합니다. SAML을 사용하여 Edge와 통신하도록 개발자 서비스 포털 구성을 참고하세요.

현재 보안 프로필 보기

Edge 보안 프로필을 보고 현재 구성을 확인하여 기본 인증 및 SAML이 현재 사용 설정되어 있는지 확인할 수 있습니다. Edge에서 사용하는 현재 보안 프로필을 보려면 에지 관리 서버에서 다음 에지 관리 API 호출을 사용합니다.

> curl -H "accept:application/xml" http://localhost:8080/v1/securityprofile -u sysAdminEmail:pWord

아직 SAML을 구성하지 않은 경우 아래와 같은 응답이 표시되며 이는 기본 인증이 사용 설정되었다는 의미입니다.

<SecurityProfile enabled="true" name="securityprofile">
    <UserAccessControl enabled="true">
    </UserAccessControl>
</SecurityProfile>

이미 SAML을 사용 설정한 경우 출력에 <ssoserver> 태그가 표시됩니다.

<SecurityProfile enabled="true" name="securityprofile">
    <UserAccessControl enabled="true">
        <SSOServer>
            <BasicAuthEnabled>true</BasicAuthEnabled>
            <PublicKeyEndPoint>/token_key</PublicKeyEndPoint>
            <ServerUrl>http://35.197.37.220:9099</ServerUrl>
        </SSOServer>
    </UserAccessControl>
</SecurityProfile>

SAML이 사용 설정된 버전에서도 <BasicAuthEnabled>true</BasicAuthEnabled>가 표시되므로 기본 인증이 계속 사용 설정되어 있습니다.

기본 인증 사용 중지

에지 관리 서버에서 다음 에지 관리 API 호출을 사용하여 기본 인증을 사용 중지합니다. 이전 섹션에서 반환한 XML 객체를 페이로드로 전달합니다. 유일한 차이점은 다음과 같이 <BasicAuthEnabled>false</BasicAuthEnabled>를 설정한다는 것입니다.

> curl -H "Content-Type: application/xml"
http://localhost:8080/v1/securityprofile  -u sysAdminEmail:pWord -d
 '<SecurityProfile enabled="true" name="securityprofile">
  <UserAccessControl enabled="true">
    <SSOServer>
      <BasicAuthEnabled>false</BasicAuthEnabled>
      <PublicKeyEndPoint>/token_key</PublicKeyEndPoint>
      <ServerUrl>http://35.197.37.220:9099</ServerUrl>
  </SSOServer>
 </UserAccessControl>
</SecurityProfile>'

기본 인증을 사용 중지하면 기본 인증 사용자 인증 정보를 전달하는 에지 관리 API 호출이 다음 오류를 반환합니다.

<Error>
    <Code>security.SecurityProfileBasicAuthDisabled</Code>
    <Message>Basic Authentication scheme not allowed</Message>
    <Contexts/>
</Error>

기본 인증 다시 사용 설정

어떤 이유로든 기본 인증을 다시 사용 설정해야 하는 경우 다음 단계를 수행해야 합니다.

주의: 기본 인증을 다시 사용 설정하는 과정에서 SAML을 포함한 Edge의 모든 인증을 일시적으로 사용 중지해야 합니다.

1. Edge JoKeeper 노드에 로그인합니다.
2. 다음 bash 스크립트를 실행하여 모든 보안을 사용 중지합니다.
   주의: 이 단계에서는 SAML을 포함한 Edge의 모든 인증이 사용 중지됩니다.
   
   #! /bin/bash
   
   /opt/apigee/apigee-zookeeper/bin/zkCli.sh -server localhost:2181 <<EOF
   /system/securityprofile <SecurityProfile></SecurityProfile> 설정
   종료
   EOF
   
   다음과 같은 형식으로 출력이 표시됩니다.
   localhost:2181에 연결
   zooKeeper에 오신 것을 환영합니다.
   JLine 지원이 사용 설정되었습니다.
   WATCHER::
   
   WatchedEvent state:SyncConnected type:None path:null
   [zk: localhost:2181(CONNECTED) 0] /system/securityprofile <SecurityProfile></SecurityProfile> 설정
   cZxid = 0x89
   ...
   [zk: localhost:2181(CONNECTED) 1] quit
   종료 중...
3. 기본 인증 및 SAML 인증을 다시 사용 설정합니다.
   

   > curl -H "Content-Type: application/xml"
   http://localhost:8080/v1/securityprofile -u sysAdminEmail:pWord -d
   '<SecurityProfile enabled="true" name="securityprofile">
   <UserAccessControl enabled="true">
   <UserAccessControl enabled="true"> <UserAccessControl enabled="true"> <SSOServer >
   
   
   
   
   
   

   이제 기본 인증을 다시 사용할 수 있습니다.