Dê à sua conta Databricks uma URL personalizada
Visualização
Este recurso está em Pré-visualização Pública.
Um URL personalizado fornece à sua conta Databricks um ponto de entrada único e de marca (por exemplo: acme.databricks.com) que substitui a coleção de URLs por espaço de trabalho que os usuários da conta precisam navegar atualmente. Após habilitar uma URL personalizada, os usuários podem iniciar sessão na conta Databricks e navegar livremente entre workspaces e o Genie One sem precisar se autenticar novamente.
Elegibilidade
Os administradores de account elegíveis podem reivindicar e habilitar um URL personalizado diretamente do console da account. Os seguintes requisitos de elegibilidade se aplicam:
- Sua account deve ser uma account de cliente pagante e verificada.
- O administrador account que habilita o URL personalizado deve ter um endereço de email de domínio não reservado.
Se você foi atribuído anteriormente a um URL personalizado, ele aparecerá automaticamente nas configurações da sua conta. Para renomear seu URL personalizado, entre em contato com sua equipe de conta da Databricks.
A Databricks reserva-se o direito de alterar, reivindicar ou revogar um URL personalizado a qualquer momento. Sempre que possível, fornecemos aviso prévio e ajudamos a coordenar uma substituição.
Requisitos
- Sua account precisa estar habilitada para login unificado. Contas criadas após 21 de junho de 2023 e aquelas que configuraram SSO após 12 de dezembro de 2024 terão essa funcionalidade ativada automaticamente.
- Seu espaço de trabalho não deve usar o recurso Private Link Inbound (front-end). Os URLs para espaços de trabalho protegidos por Link Privado de entrada voltam a usar os URLs legados porworkspace .
- O Private Link de entrada para recursos de nível de conta (como o console da conta e o Genie One de nível de conta) é compatível na versão Beta.
Atribua um URL personalizado
Se um URL personalizado já tiver sido atribuído a você, ele aparecerá automaticamente nas configurações da sua account. Se desejar renomear seu URL personalizado existente, entre em contato com a equipe da sua conta Databricks.
- No console account , acesse Configurações > configurações da conta .
- Clique no botão **Reivindicar sua URL** para habilitar a URL personalizada.
- Opcionalmente, ative a configuração de redirecionamento automático para redirecionar todos os URLs de workspace legados para seu URL Personalizado.
Após ativar o URL personalizado, acesse o Genie One em acme.databricks.com/one. Usuários em sua conta agora podem acessar ativos em qualquer workspace a que tenham acesso sem que seja solicitado que façam log in novamente.
Suporte a ferramentas para desenvolvedores
As seguintes ferramentas para desenvolvedores da Databricks oferecem suporte a URLs personalizadas. Atualize para pelo menos a versão mínima listada para garantir a compatibilidade.
Ferramenta | Versão mínima |
|---|---|
CLI/DABs | 1.0.0 |
Terraform | 1.114.0 |
SDK Go | 0.130.0 |
SDK Python | 0.103.0 |
SDK Java | 0.105.0 |
Extensão do VS Code | 2.11.0 |
O que muda quando você usa um URL personalizado
A maioria das funcionalidades do Databricks funciona como está quando você começa a usar um URL personalizado. Os seguintes aplicativos e integrações exigem configuração adicional.
Conexões do Unity Catalog com OAuth
Para conexões do Unity Catalog que solicitam aos usuários que façam login com OAuth por meio de um aplicativo terceirizado gerenciado pelo cliente, adicione um URI de retorno de chamada que use a URL personalizada aos URIs de redirecionamento permitidos do aplicativo. Mantenha o URI de retorno de chamada que usa a URL do workspace se os usuários ainda puderem acessar essa URL. O caminho de retorno de chamada varia de acordo com o tipo de conexão. Por exemplo, para uma conexão HTTP, adicione https://<custom-url>/login/oauth/http.html à lista de permissões de URLs de redirecionamento do aplicativo de terceiros.
Dashboards incorporados para usuários externos
Para usar sua URL personalizada para painéis incorporados para usuários externos, atualize seu aplicativo de incorporação:
- Substitua a URL da instância específica do workspace pela sua URL personalizada.
- Adicione o ID do workspace de destino às solicitações
/oidc/v1/tokene/api/2.0/lakeview/dashboards/<dashboard-id>/published/tokeninfousando o parâmetro de queryo=<workspace-id>. Use?o=<workspace-id>quando for o primeiro parâmetro de query, ou&o=<workspace-id>quando a URL já tiver parâmetros de query.
Consulte Usar o aplicativo de exemplo para autenticar e gerar tokens para obter exemplos completos em Python e JavaScript.