From a983e4439326523b4b4a11059acd1a6dd22a0fc3 Mon Sep 17 00:00:00 2001 From: julia-rabello <77292838+julia-rabello@users.noreply.github.com> Date: Thu, 21 May 2026 11:46:43 -0300 Subject: [PATCH 1/4] new: auth method setup org unit guide --- ...autenticacao-por-unidade-organizacional.md | 73 +++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 docs/pt/tutorials/b2b/organization-account/configurar-metodos-de-autenticacao-por-unidade-organizacional.md diff --git a/docs/pt/tutorials/b2b/organization-account/configurar-metodos-de-autenticacao-por-unidade-organizacional.md b/docs/pt/tutorials/b2b/organization-account/configurar-metodos-de-autenticacao-por-unidade-organizacional.md new file mode 100644 index 0000000000..a9ec8b913b --- /dev/null +++ b/docs/pt/tutorials/b2b/organization-account/configurar-metodos-de-autenticacao-por-unidade-organizacional.md @@ -0,0 +1,73 @@ +--- +title: 'Configurar métodos de autenticação por unidade organizacional' +createdAt: '2026-05-21T14:37:00.000Z' +updatedAt: '2026-05-21T14:37:00.000Z' +contentType: tutorial +productTeam: B2B +slugEN: configure-authentication-methods-per-organizational-unit +locale: pt +--- + +No B2B, cada unidade organizacional pode ter suas configurações de autenticação definidas de forma independente. Isso permite que diferentes filiais ou divisões de uma mesma organização utilizem formas de login distintas conforme suas necessidades. + +## Configurações disponíveis + +As configurações de autenticação são divididas em dois grupos principais: **Identificação do usuário** e **Métodos de autenticação**. Cada grupo pode ter uma ou mais opções habilitadas, dependendo das necessidades da organização. + +### Identificação do usuário + +Define quais identificadores o usuário pode informar ao iniciar o login (nome de usuário, email ou ambos nome de usuário e/ou email). + +| Identificador | Descrição | +| :---- | :---- | +| **Nome de usuário** | O usuário informa seu nome de usuário para iniciar o login. | +| **Email** | O usuário informa seu endereço de email para iniciar o login. | + +### Métodos de autenticação + +Define como o usuário será autenticado após a identificação (por senha, provedor de identidade externo ou ambos). + +| Método | Descrição | +| :---- | :---- | +| **Password** | O usuário é autenticado com senha cadastrada na plataforma VTEX. | +| **IdP externo (SSO)** | O usuário é redirecionado para um provedor de identidade externo configurado pelo lojista para autenticação via Single Sign-On. Saiba mais em [Habilitar login na organização via provedor de identidade (IdP) externo](https://help.vtex.com/pt/docs/tutorials/habilitar-login-na-organizacao-via-provedor-de-identidade-idp-externo). | + +É possível habilitar uma ou mais opções em cada grupo. Opções não habilitadas ficam indisponíveis para os membros da unidade organizacional. + +## Pré-requisitos + +* Ter o perfil **Organizational Unit Admin** na organização compradora. +* Para habilitar o login via IdP externo, o lojista precisa ter configurado previamente o provedor de identidade no Admin VTEX. Saiba mais em [Login (SSO)](https://developers.vtex.com/docs/guides/login-integration-guide) e [Webstore (OAuth 2.0)](https://developers.vtex.com/docs/guides/login-integration-guide-webstore-oauth2). +* Ter o app [vtex.login-alternative-key](https://developers.vtex.com/docs/apps/vtex.login-alternative-key) instalado na loja. + +## Configurar métodos de autenticação na Conta da Organização + +Para configurar os métodos de autenticação diretamente pela [tela inicial da Conta da Organização](https://help.vtex.com/pt/docs/tutorials/conta-da-organizacao#acessando-a-conta-da-organizacao), siga os passos abaixo: + +1. Acesse a loja pelo navegador e faça login com seu usuário. +2. No menu superior, clique em **Company**. O painel da organização será exibido. +3. Clique em **Manage**. +4. Se quiser configurar os métodos da organização principal, prossiga para a etapa 5. Se quiser configurar uma unidade organizacional filha, clique em **Organizational Units** e depois no nome da unidade. +5. Clique no menu **⋮** e, em seguida, em **Authentication**. +6. No modal **Authentication**, configure as opções desejadas: + + * Em **User identification**, marque os identificadores que os membros poderão usar para iniciar o login (**username**, **email** ou ambos). + * Em **Authentication methods**, marque os métodos de autenticação disponíveis (**password**, **external IdP** ou ambos). Desmarque os que não devem estar disponíveis. +7. Clique em **Save**. + +## Configurar métodos de autenticação via API + +Também é possível gerenciar os métodos de autenticação por unidade organizacional via API. Os endpoints disponíveis são: + +| Método | Endpoint | Descrição | +| :---- | :---- | :---- | +| `GET` | [Get organization unit authentication settings](https://developers.vtex.com/docs/api-reference/vtex-id-api#get-/api/vtexid/organization-units/-unitId-/settings) | Consulta os métodos de autenticação configurados para uma unidade organizacional. | +| `POST` | [Set organization unit authentication settings](https://developers.vtex.com/docs/api-reference/vtex-id-api#post-/api/vtexid/organization-units/-unitId-/settings) | Define os métodos de autenticação de uma unidade organizacional. | +| `PATCH` | [Update organization unit authentication settings](https://developers.vtex.com/docs/api-reference/vtex-id-api#patch-/api/vtexid/organization-units/-unitId-/settings) | Atualiza parcialmente os métodos de autenticação de uma unidade organizacional. | +| `DELETE` | [Delete organization unit authentication setting](https://developers.vtex.com/docs/api-reference/vtex-id-api#delete-/api/vtexid/organization-units/-unitId-/settings) | Remove um método de autenticação de uma unidade organizacional. | + +## Saiba mais + +* [Habilitar login na organização via provedor de identidade (IdP) externo](https://help.vtex.com/pt/docs/tutorials/habilitar-login-na-organizacao-via-provedor-de-identidade-idp-externo) +* [Login (SSO)](https://developers.vtex.com/docs/guides/login-integration-guide) +* [Webstore (OAuth 2.0)](https://developers.vtex.com/docs/guides/login-integration-guide-webstore-oauth2) From af7ed150e4f2c072d02f49b0f7f380a131012299 Mon Sep 17 00:00:00 2001 From: julia-rabello <77292838+julia-rabello@users.noreply.github.com> Date: Thu, 21 May 2026 11:46:54 -0300 Subject: [PATCH 2/4] loc: add placeholder files for localization --- ...ure-authentication-methods-per-organizational-unit.md | 9 +++++++++ ...r-metodos-de-autenticacion-por-unidad-organizativa.md | 9 +++++++++ 2 files changed, 18 insertions(+) create mode 100644 docs/en/tutorials/b2b/organization-account/PLACEHOLDER-configure-authentication-methods-per-organizational-unit.md create mode 100644 docs/es/tutorials/b2b/organization-account/PLACEHOLDER-configurar-metodos-de-autenticacion-por-unidad-organizativa.md diff --git a/docs/en/tutorials/b2b/organization-account/PLACEHOLDER-configure-authentication-methods-per-organizational-unit.md b/docs/en/tutorials/b2b/organization-account/PLACEHOLDER-configure-authentication-methods-per-organizational-unit.md new file mode 100644 index 0000000000..a68afd99fe --- /dev/null +++ b/docs/en/tutorials/b2b/organization-account/PLACEHOLDER-configure-authentication-methods-per-organizational-unit.md @@ -0,0 +1,9 @@ +--- +title: 'Configure authentication methods per organizational unit' +createdAt: '2026-05-21T14:37:00.000Z' +updatedAt: '2026-05-21T14:37:00.000Z' +contentType: tutorial +productTeam: B2B +slugEN: configure-authentication-methods-per-organizational-unit +locale: en +--- diff --git a/docs/es/tutorials/b2b/organization-account/PLACEHOLDER-configurar-metodos-de-autenticacion-por-unidad-organizativa.md b/docs/es/tutorials/b2b/organization-account/PLACEHOLDER-configurar-metodos-de-autenticacion-por-unidad-organizativa.md new file mode 100644 index 0000000000..21e8bf116a --- /dev/null +++ b/docs/es/tutorials/b2b/organization-account/PLACEHOLDER-configurar-metodos-de-autenticacion-por-unidad-organizativa.md @@ -0,0 +1,9 @@ +--- +title: 'Configurar métodos de autenticación por unidad organizativa' +createdAt: '2026-05-21T14:37:00.000Z' +updatedAt: '2026-05-21T14:37:00.000Z' +contentType: tutorial +productTeam: B2B +slugEN: configure-authentication-methods-per-organizational-unit +locale: es +--- From 6b2f7facd99abb1d11abbd7071e0f9f0bf0d7b62 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 21 May 2026 14:48:35 +0000 Subject: [PATCH 3/4] chore(nav): update navigation.json via vtexhelp-nav-cli --- public/navigation.json | 45 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/public/navigation.json b/public/navigation.json index 832b79ee0a..edc76a0ced 100644 --- a/public/navigation.json +++ b/public/navigation.json @@ -17395,6 +17395,21 @@ "type": "markdown", "children": [] }, + { + "name": { + "en": "Configure authentication methods per organizational unit", + "es": "Configurar métodos de autenticación por unidad organizativa", + "pt": "Configurar métodos de autenticação por unidade organizacional" + }, + "slug": { + "en": "placeholder-configure-authentication-methods-per-organizational-unit", + "es": "placeholder-configurar-metodos-de-autenticacion-por-unidad-organizativa", + "pt": "configurar-metodos-de-autenticacao-por-unidade-organizacional" + }, + "origin": "", + "type": "markdown", + "children": [] + }, { "name": { "en": "Contract settings", @@ -58344,6 +58359,21 @@ "type": "markdown", "children": [] }, + { + "name": { + "en": "Scenarios Involving Goodwill Following an Order Modification", + "es": "Situaciones relacionadas con el fondo de comercio tras una modificación de la orden", + "pt": "Cenários envolvendo ágio após uma modificação de pedido" + }, + "slug": { + "en": "scenarios-involving-goodwill-following-an-order-modification", + "es": "situaciones-relacionadas-con-el-fondo-de-comercio-tras-una-modificacion-de-la-orden", + "pt": "cenarios-envolvendo-agio-apos-uma-modificacao-de-pedido" + }, + "origin": "", + "type": "markdown", + "children": [] + }, { "name": { "en": "Seller's order invoiced with problem in the payment capture", @@ -67656,6 +67686,21 @@ "type": "markdown", "children": [] }, + { + "name": { + "en": "Sitemap retains ghost products from categories removed via full cleanup", + "es": "El mapa del sitio conserva los productos fantasma de las categorías eliminadas mediante una limpieza completa", + "pt": "O mapa do site mantém produtos fantasmas de categorias removidas por meio de uma limpeza completa" + }, + "slug": { + "en": "sitemap-retains-ghost-products-from-categories-removed-via-full-cleanup", + "es": "el-mapa-del-sitio-conserva-los-productos-fantasma-de-las-categorias-eliminadas-mediante-una-limpieza-completa", + "pt": "o-mapa-do-site-mantem-produtos-fantasmas-de-categorias-removidas-por-meio-de-uma-limpeza-completa" + }, + "origin": "", + "type": "markdown", + "children": [] + }, { "name": { "en": "Sitemap returns \"Error fetching sitemap data\"", From ae3652548194d6aa3a91a146e37f2d6e18d3c639 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=BAlia=20Rabello?= <77292838+julia-rabello@users.noreply.github.com> Date: Thu, 21 May 2026 14:32:08 -0300 Subject: [PATCH 4/4] update: add buyer portal callout --- ...igurar-metodos-de-autenticacao-por-unidade-organizacional.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/pt/tutorials/b2b/organization-account/configurar-metodos-de-autenticacao-por-unidade-organizacional.md b/docs/pt/tutorials/b2b/organization-account/configurar-metodos-de-autenticacao-por-unidade-organizacional.md index a9ec8b913b..12be174d15 100644 --- a/docs/pt/tutorials/b2b/organization-account/configurar-metodos-de-autenticacao-por-unidade-organizacional.md +++ b/docs/pt/tutorials/b2b/organization-account/configurar-metodos-de-autenticacao-por-unidade-organizacional.md @@ -8,6 +8,8 @@ slugEN: configure-authentication-methods-per-organizational-unit locale: pt --- +> ⚠️ Esta funcionalidade está disponível apenas para lojas que usam [B2B Buyer Portal](https://help.vtex.com/pt/docs/tutorials/b2b-buyer-portal-pt), atualmente disponível para contas selecionadas. + No B2B, cada unidade organizacional pode ter suas configurações de autenticação definidas de forma independente. Isso permite que diferentes filiais ou divisões de uma mesma organização utilizem formas de login distintas conforme suas necessidades. ## Configurações disponíveis