Desativar a autenticação básica no Edge

Depois de ativar o SAML ou o LDAP no Edge, você pode desativar a autenticação básica. No entanto, antes de desativar a autenticação básica:

  • Adicione todos os usuários do Edge, incluindo administradores do sistema, ao seu IDP.
  • Teste a autenticação do IdP na nova interface do Edge e na API Management do Edge.

Conferir o perfil de segurança atual

Você pode conferir o perfil de segurança do Edge para determinar a configuração atual e saber se a autenticação básica e um IdP externo estão ativados. Use a seguinte chamada de API de gerenciamento do Edge no servidor de gerenciamento do Edge para conferir o perfil de segurança atual usado pelo Edge:

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

Se você ainda não tiver configurado um IdP externo, a resposta será mostrada abaixo, o que significa que a autenticação básica está ativada:

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

Se você já tiver ativado um IdP externo, o elemento <ssoserver> vai aparecer na resposta:

<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>

A versão com um IdP externo ativado também mostra <BasicAuthEnabled>true</BasicAuthEnabled>, o que significa que a autenticação básica ainda está ativada.

Desativar a autenticação básica

Use a seguinte chamada da API de gerenciamento do Edge no servidor de gerenciamento do Edge para desativar a autenticação básica.

Para desativar a autenticação básica, transmita o objeto XML retornado na seção anterior como o payload. A única diferença é que você define <BasicAuthEnabled> como false, conforme mostrado no exemplo a seguir:

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>'

Depois de desativar a autenticação Basic, qualquer chamada de API de gerenciamento do Edge que transmita credenciais de autenticação Basic vai retornar o seguinte erro:

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

Reativar a autenticação básica

Se por algum motivo você precisar reativar a autenticação básica, siga estas etapas:

  1. Faça login em qualquer nó do ZooKeeper do Edge.
  2. Execute o seguinte script bash para desativar toda a segurança:
    #! /bin/bash
    /opt/apigee/apigee-zookeeper/bin/zkCli.sh -server localhost:2181 <<EOF
    set /system/securityprofile <SecurityProfile></SecurityProfile>
    quit
    EOF

    A saída será exibida no formato:

    Connecting to localhost:2181
    Welcome to ZooKeeper!
    JLine support is enabled
    WATCHER::
    WatchedEvent state:SyncConnected
    type:None path:null
    [zk: localhost:2181(CONNECTED) 0]
    set /system/securityprofile <SecurityProfile></SecurityProfile>
    cZxid = 0x89
    ...
    [zk: localhost:2181(CONNECTED) 1] quit
    Quitting...
  3. Reative a autenticação básica e a autenticação do IdP externo:
    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>true</BasicAuthEnabled>
      <PublicKeyEndPoint>/token_key</PublicKeyEndPoint>
      <ServerUrl>http://35.197.37.220:9099</ServerUrl>
      </SSOServer>
      </UserAccessControl>
      </SecurityProfile>'

Agora você pode usar a autenticação básica novamente. Para mudar a nova interface do Edge do SSO de volta para a autenticação básica, defina AUTH_MODE=basic e MANAGEMENT_UI_SSO_ENABLED=n no arquivo de configuração da nova interface do Edge e execute /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile seguido por /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart (ou execute /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile).