---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# StandardCredentialsProvider - com escopo, global

# StandardCredentialsProvider - com escopo, global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A API StandardCredentialsProvider fornece métodos para recuperar informações de credenciais.

Você pode usar esta API em aplicações com escopo ou dentro do escopo global. Em scripts com escopo, use o identificador de namespace `sn_cc`.

Esta API fornece métodos para recuperar informações de credencial por sys_id e por atributos de credencial especificados.  

    //Get a single credential

    var provider = new sn_cc.StandardCredentialsProvider();
    var credential = provider.getCredentialByID("f43c6d40a0a0b5700c77f9bf387afe3");
    var userName = credential.getAttribute("user_name");
    var password = credential.getAttribute("password");
    //using getAttribute for new keys in extended tables, for example 
    //cloud management credential has the "user_public_key" attribute
    var userPublicKey = credential.getAttribute("user_public_key");

    //Get a list of SSH credentials

    var provider = new sn_cc.StandardCredentialsProvider();
    var credentials = provider.getCredentials(["ssh"]);
    for (var i = 0; i < credentials.length; i++) {
      var credential = credentials[i];
      gs.info(credential.getAttribute("name"));
    }

## StandardCredentialsProvider - StandardCredentialsProvider() {#ariaid-title2}

Instancia um objeto de provedor de credenciais.
{#SCP-standard-credential-provider__table_afx_pp2_qbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#SCP-standard-credential-provider__table_afx_pp2_qbb}  

    var provider = new sn_cc.StandardCredentialsProvider();
    var credentials = provider.getCredentialByID("ef43c6d40a0a0b5700c77f9bf387afe3");

## StandardCredentialsProvider - getCredentials (tipos de cadeia de caracteres, marcadores de cadeia de caracteres) {#ariaid-title3}

Retorna uma matriz de todas as credenciais que correspondem aos tipos e marcadores especificados.
{#SCP-getCredentials_S__table_xxn_xq2_qbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| marcadores | Cadeia de caracteres | Opcional. Lista separada por vírgulas de nomes de marcadores. Por exemplo, "ssh, jdbc". Exemplos de chamadas válidas: * ` credenciais var = provider.getCredentials(null, null);` * `var credenciais = provider.getCredentials(["ssh"], "");` * `credenciais var = provider.getCredentials(new ArrayList<String> (), "ssh,admin");` {#SCP-getCredentials_S__ul_fsr_sf2_4nb} |
| tipos | Matriz | Opcional. Nomes do tipo de credencial. Por exemplo, \["ssh", "windows"\] Nota: Se types for nulo ou vazio, qualquer correspondência retornará uma credencial. Se types for especificado, as credenciais cujo tipo corresponda a um dos tipos serão retornadas. |
[Tabela 2. Parâmetros]

{#SCP-getCredentials_S__table_xxn_xq2_qbb} {#SCP-getCredentials_S__table_yxn_xq2_qbb__entry__2}

| Tipo | Descrição |
|-|-|
| Credencial padrão | Objeto de registro de credencial. |
[Tabela 3. Retorna]

{#SCP-getCredentials_S__table_yxn_xq2_qbb}  
Este exemplo de código mostra como obter as credenciais do provedor para tipos de credenciais "ssh".

    var provider = new sn_cc.StandardCredentialsProvider();
    var credentials = provider.getCredentials(["ssh"]);

Este exemplo de código mostra como obter as credenciais do provedor para os tipos de credencial "ssh" e "windows" que têm marcadores de "admin".

    var provider = new sn_cc.StandardCredentialsProvider();
    ArrayList<String> types = new ArrayList<>();
    types.add("ssh");
    types.add("windows");
    JSONArray jsonArray = provider.getCredentials(types, "admin");

## StandardCredentialsProvider -- getCredentialByAliasID(cadeia de caracteres sys_id) {#ariaid-title4}

Retorna o objeto de registro de credencial por meio de seu alias de credencial (sys_alias).
Este método é especificamente para uso com tipos de credenciais. Para obter informações, consulte [Credential aliases for Discovery](https://www.servicenow.com/docs/access?context=discovery-credential-alias&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US).
{#SCP-getCredentialByAliasID_S__table_xxn_xq2_qbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sys_id | Cadeia de caracteres | Sys_id do registro de alias de credencial na tabela Aliases de conexão e credencial \[sys_alias\]. |
[Tabela 4. Parâmetros]

{#SCP-getCredentialByAliasID_S__table_xxn_xq2_qbb} {#SCP-getCredentialByAliasID_S__table_yxn_xq2_qbb__entry__2}

| Tipo | Descrição |
|-|-|
| Credencial padrão | Objeto de registro de credencial. |
[Tabela 5. Retorna]

{#SCP-getCredentialByAliasID_S__table_yxn_xq2_qbb}  
O exemplo a seguir recupera uma credencial usando o ID do alias e exibe o nome de usuário.

    var provider = new sn_cc.StandardCredentialsProvider();
    var aliasCred = provider.getCredentialByAliasID("752a91887740001038e286a2681061fb");
    gs.info("User name: " + aliasCred.getAttribute("user_name"));

Saída para um registro de credencial com um nome de usuário:

    User name: Dara Lee

## StandardCredentialsProvider -- getCredentialByID(cadeia de caracteres sys_id) {#ariaid-title5}

Retorna o objeto de registro de credencial identificado pelo sys_id especificado.
{#SCP-getCredentialByID_S__table_xxn_xq2_qbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sys_id | Cadeia de caracteres | Sys_id do registro de credencial. Localizado na tabela Credenciais \[discovery_credentials\]. |
[Tabela 6. Parâmetros]

{#SCP-getCredentialByID_S__table_xxn_xq2_qbb} {#SCP-getCredentialByID_S__table_yxn_xq2_qbb__entry__2}

| Tipo | Descrição |
|-|-|
| Credencial padrão | Objeto de registro de credencial. |
[Tabela 7. Retorna]

{#SCP-getCredentialByID_S__table_yxn_xq2_qbb}  
O exemplo a seguir recupera uma credencial e exibe o nome de usuário.

    var provider = new sn_cc.StandardCredentialsProvider();
    var credentials = provider.getCredentialByID("ef43c6d40a0a0b5700c77f9bf387afe3");
    gs.info("User name: " + credentials.getAttribute("user_name"));

Saída para um registro de credencial com um nome de usuário:

    User name: Dara Lee