Conectar o login do Kakao

Para que o cliente se cadastre com uma conta Kakao, primeiro você registra o seu serviço no Kakao e recebe dois valores. São a REST API key e o Client Secret.

Esta página apresenta a ordem para obter esses dois valores. O modo de colocar na WEEGLOO os valores recebidos está em Colocar na WEEGLOO os valores recebidos.

O endereço a copiar primeiro

Quando o cliente termina o login no Kakao, o Kakao devolve esse resultado para um endereço definido. Você precisa registrar esse endereço no Kakao, então copie-o primeiro. Você vai colá-lo na etapa 5.

Escolha o seu Space abaixo para obter o endereço com o identificador já preenchido.

Space
https://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/kakao

Se preferir preencher por conta própria, coloque no lugar de {spaceId} o identificador do seu Space. Abra esse Space no estúdio de conteúdo e olhe a barra de endereços do navegador: o valor que vem depois de /spaces/ é o identificador.

Esse endereço não é o endereço do seu site. É o lugar onde a WEEGLOO recebe o resultado do login. Por isso ele já fica definido agora, mesmo que você ainda não tenha feito o seu site. Se você ativou o Kakao no estúdio de conteúdo, o mesmo endereço aparece no Step 1, então você também pode copiá-lo de lá.

Obter os dois valores no Kakao

Depois de entrar no Kakao, siga em ordem as cinco etapas abaixo.

1

Criar o app

  1. Abra a tela das suas aplicações (https://developers.kakao.com/console/app).

  2. Clique em Create app (criar app).

  3. Em App icon (ícone do app), carregue uma imagem.

  4. Em App name (nome do app), digite o nome que o cliente vai ver (por exemplo, Cozy Closet).

  5. Em Company name (nome da empresa), digite o nome da sua loja ou da sua empresa. Pode ser igual ao nome do app.

  6. Em Category (categoria), escolha a que corresponde ao seu serviço (por exemplo, Lifestyle).

  7. Em App primary domain (domínio principal do app), digite o endereço do seu site (por exemplo, https://pogeun-otjang.com).

  8. Marque, no fim do formulário, a caixa de consentimento com a política de operação.

  9. Clique em Save (guardar).

    Modal de criação do app. O App icon está com uma imagem carregada, App name e Company name estão com "Cozy Closet" e App primary domain está com o endereço do site

2

Converter em Biz app

Sem a conversão em Biz app, não é possível definir o e-mail como item de consentimento obrigatório.

  1. Abra o app que você acabou de criar e vá para App Settings → App → General (definições do app → app → geral).

  2. Encontre a seção Business information (informações comerciais).

    Seção Business information. Há o botão Register business information e o aviso "This app is not a Biz app." e, abaixo, o botão Switch to Biz app for an individual

O caminho se divide conforme você tenha ou não um número de registro comercial. Siga apenas o lado que corresponde à sua situação.

  1. Clique em Register business information (registrar informações comerciais).
  2. Em Business Type (tipo de negócio), escolha Domestic business (Korea). Se o seu negócio não for coreano, escolha Overseas business (outside Korea).
  3. Digite o Business registration number (número de registro comercial).
  4. Clique em Confirm (confirmar).

Modal de informações comerciais. Em Business Type está selecionado Domestic business (Korea) e, abaixo, estão os três campos do número de registro comercial

  1. Conclua a verificação de identidade.
  2. Clique em Switch to Biz app for an individual (converter em Biz app como pessoa física).
  3. Em Purpose (finalidade), escolha To set email to Required consent item (definir o e-mail como item de consentimento obrigatório).
  4. Clique em Save.

Modal de conversão em Biz app para pessoa física. Em Purpose está selecionado To set email to Required consent item

Se você nunca consentiu com os termos do serviço integrado do Kakao Business, ao clicar em Save abre-se a tela de consentimento dos termos. Com o consentimento, a conversão segue adiante.

Em qualquer um dos caminhos, quando a conversão termina, o selo acima do nome do app muda para Biz app.

3

Ativar o login do Kakao

  1. Vá para Product Settings → Kakao Login → General (definições do produto → Kakao Login → geral).

  2. Ative o botão State (estado), em Usage settings (definições de uso).

  3. No diálogo de confirmação, clique em Activate (ativar).

    Tela Product Settings → Kakao Login → General. O botão State, em Usage settings, está ativado e, abaixo dele, está o botão OpenID Connect

Ao ativar esse botão, aparece abaixo o botão OpenID Connect. Deixe esse botão como está.

4

Configurar os itens de consentimento

Você precisa mudar os três itens abaixo para Required consent (consentimento obrigatório).

NomePurpose of consent
EmailMember identification
NicknameDisplay member name
Profile imageDisplay member profile

  1. Vá para Product Settings → Kakao Login → Consent Items (itens de consentimento).

  2. Na tabela Personal information (informações pessoais), clique em Set (definir), na linha Email.

  3. Escolha Required consent.

  4. Em Purpose of consent (finalidade do consentimento), digite Member identification.

  5. Clique em Save.

    Modal de configuração do item de consentimento. Em Email está selecionado Required consent e em Purpose of consent está digitado "Member identification"

  6. Mude Nickname do mesmo modo, a partir do item 2. O Purpose of consent é Display member name.

  7. Mude Profile image do mesmo modo, a partir do item 2. O Purpose of consent é Display member profile.

  8. Confirme que o State dos três itens está em Required consent.

    Tabela Personal information, na tela de itens de consentimento. Nickname, Profile image e Email estão todos com o State Required consent e os demais itens estão com o State Unauthorized

É preciso mudar os três itens

Se você deixar qualquer um deles de fora, o cliente fica travado numa tela de erro do Kakao antes mesmo de começar o login.

5

Copiar a REST API key e o Client Secret

  1. Vá para App Settings → App → Platform Key (chave de plataforma).

    Tela App Settings → App → Platform Key. Os três cartões REST API key, JavaScript key e Native app key estão lado a lado

  2. Clique no cartão REST API key.

    Tela Edit REST API key. No topo está o valor da REST API key, abaixo aparece o campo Kakao Login Redirect URI vazio e, mais abaixo, as linhas Kakao Login e Business Authentication do Client Secret

  3. Copie o valor da REST API key.

  4. No campo Kakao Login Redirect URI (URI de redirecionamento do Kakao Login), cole o endereço que você copiou em O endereço a copiar primeiro.

  5. Copie o Code (código) que está na linha Kakao Login de Client Secret.

  6. Clique em Save.

As chaves aparecem em três tipos, REST API key, JavaScript key e Native app key, e a que você vai usar é a REST API key. Em Client Secret o código também aparece em duas linhas, Kakao Login e Business Authentication (autenticação comercial), e a que você vai usar é a linha Kakao Login.

Esse único campo já basta para o endereço. O botão + ao lado serve para registrar mais endereços, então não clique nele. O Secret é um valor secreto. Não o conte a ninguém e não o escreva em um lugar público.

Colocar na WEEGLOO os valores recebidos

Agora você tem os dois valores em mãos. Veja em qual campo do estúdio de conteúdo entra cada um deles.

Tela do KakaoEstúdio de conteúdo
REST API keyREST API key
O Code de Kakao Login, em Client SecretClient Secret - Kakao Login Code

Daqui em diante o caminho se divide conforme o modo como você vinha trabalhando até aqui.

Se você estava configurando diretamente no estúdio de conteúdo, siga assim.

  1. Volte para ativar o login social em Login de membros do serviço.
  2. Ative o Kakao.
  3. Coloque a REST API key no campo REST API key do Step 2.
  4. Coloque o código do Kakao Login do Client Secret no campo Client Secret - Kakao Login Code.
  5. Clique em Guardar.

Se você entregou a integração a um agente de IA e recebeu a orientação de ir buscar os valores, cole no chat os dois valores recebidos exatamente como estão e siga com o que estava fazendo. O restante da configuração o agente trata em seguida.

Próximos passos

  • Login de membros do serviço: coloca no estúdio de conteúdo os valores recebidos e conclui o restante da configuração do login de membros.
  • Papéis e permissões de membros: cria o ServiceUserRole que define o que o membro cadastrado pode ver e usar.
  • Auth API: trata de especificações técnicas como o formato das requisições, necessárias para conectar o login ao código do seu próprio site.