zoop-package-public

Repositório publico Zoop para clientes terem acesso a produtos com facilidade

Índice Gradle Adicionando o repositório maven Gerando uma GitHub PAT Cuidados sobre a exposição da PAT

Gradle

O acesso ao repositório maven da Zoop requer autenticação, como todo repositório maven do GitHub. Por isso, é necessário usar suas credenciais do GitHub no projeto para obter quaisquer pacotes. Especificamente, você precisa de seu usuário e de uma personal access token (PAT) que possua permissão para ler e obter pacotes/artefatos de repositórios públicos.

"Como eu obtenho ou gero uma GitHub PAT?" Se você ainda não usou as PATs do GitHub, ou se não sabe ao certo que permissões conceder à PAT, não se preocupe. Veja o passo-a-passo abaixo, em Gerando uma GitHub PAT, para esclarecer essas dúvidas. Ou consulte a documentação do GitHub.

Adicionando o repositório maven

Adicione o repositório maven da Zoop ao seu arquivo build.gradle[.kts] ou similar, como no código abaixo.

// Em Kotlin.

maven {
    url = uri("https://maven.pkg.github.com/getzoop/zoop-package-public")

    credentials {
        username = "${seu-usuário-GitHub}"
        password = "${sua-PAT-GitHub}"
    }
}

Exemplo completo

repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://maven.pkg.github.com/getzoop/zoop-package-public")

        credentials {
            username = "MyCompanyGH"
            password = "github_pat_..."
        }
    }
}

Gerando uma GitHub PAT

Acesse as configurações de sua conta no GitHub e clique em Developer settings.

Em seguida, clique em Personal access tokens > Fine-grained tokens.

Clique no botão Generate new token.

Preencha o campo Token name com um nome e o campo Description com uma descrição que ajudem você a identificar o propósito desta nova PAT mais tarde. Determine o período de expiração da nova PAT em Expiration. Embora seja tentador a configurar para que não expire, recomendamos não fazê-lo. Se a PAT vier a tornar-se obsoleta e esquecida, por qualquer motivo, pelo menos ela será revogada automaticamente, mitigando transtornos.

Em Repository access, marque a opção Public Repositories (read-only).

Você também pode marcar All repositories, ao invés disso. Porém, será necessário conceder permissões adicionais. Nesse caso, em Permissions > Repository permissions > Actions, selecione a opção Read-only.

Clique no botão Generate token para finalizar o processo. Copie agora a chave apresentada e armazene-a. É essa a chave que será usada nas credenciais de acesso ao repositório maven da Zoop.

Cuidados sobre a exposição da PAT

O GitHub dispõe de mecanismos de segurança que monitoram os repositórios em busca de vazamentos de credenciais, incluindo as PATs de seus usuários. Caso uma PAT seja detectada dentro de um repositório público, o GitHub poderá revogá-la automaticamente, expirando-a. Portanto, atente-se quanto à exposição de suas PATs para que não sejam revogadas.