Skip to content

Commit

Permalink
refactor: update feishu connector guide (#942)
Browse files Browse the repository at this point in the history
  • Loading branch information
@charIeszhao
charIeszhao authored Dec 20, 2024
1 parent aacf259 commit 6cb7240
Show file tree
Hide file tree
Showing 8 changed files with 96 additions and 97 deletions.
4 changes: 1 addition & 3 deletions docs/integrations/fragments/_guide-tip.mdx
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
:::tip

In this guide, we assume you have basic knowledge of Logto Connectors. If you don't, check out the [Configure connectors](/connectors) guide to get started.

This guide assumes you have basic understanding of Logto Connectors. For those unfamiliar, please refer to the [Connectors](/connectors) guide to get started.
:::
29 changes: 15 additions & 14 deletions docs/integrations/social/feishu-web/README.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,27 +8,28 @@ sidebar_custom_props:

import GuideTip from '../../fragments/_guide-tip.mdx';

# Set up social login with Feishu
# Set up social sign-in with Feishu

飞书网页: 先进企业协作与管理平台，一站式无缝办公协作，团队上下对齐目标，全面激活组织和个人。
Feishu Web: An advanced enterprise collaboration and management platform, offering seamless office collaboration and aligning team goals to fully activate organizations and individuals.

<GuideTip />

## 开始上手 \{#开始上手}
## Getting started with Feishu social sign-in \{#getting-started-with-feishu-social-sign-in}

飞书网页连接器是为桌面网页应用设计的。它采用了 OAuth 2.0 认证流程。
The Feishu web connector is designed for desktop web applications and uses the OAuth 2.0 authentication process.

## 注册飞书开发者账号 \{#注册飞书开发者账号}
## Register a Feishu developer account \{#register-a-feishu-developer-account}

如果你还没有飞书开发者账号，请在 [开放平台](https://open.feishu.cn/?lang=zh-CN) 注册。
If you do not have a Feishu developer account, please register on the [Feishu Open Platform](https://open.feishu.cn/app).

## 创建应用 \{#创建应用}
## Create an application \{#create-an-application}

1. [开发者首页](https://open.feishu.cn/app?lang=zh-CN) 下方有 「创建企业自建应用」
2. 填写应用名称，选择「企业自建应用」，点击「创建应用」
3. 在左侧「安全设置中」添加相应的「重定向 URL」 `${your_logto_origin}/callback/${connector_id}`。其中 `connector_id` 在管理控制台添加了相应的连接器之后，可以在连接器的详情页中找到
4. 左侧「凭证与基本信息」中可以获取「AppID」、「AppSecret」
5. 左侧「应用发布」中需要发布第一个版本「AppID」、「AppSecret」才会生效
1. On the [Developer Console](https://open.feishu.cn/app), click "Create Custom App".
2. Fill in the application name, description, select an icon, and click "Create" button.
3. In the left sidebar, click "Security Settings", fill in the "Redirect URL" as `${logto_endpoint}/callback/${connector_id}`. The corresponding value can be found in the `Callback URI` field on the Feishu connector details page in the Logto Console.
4. In "Credentials & Basic Info", you can obtain the "App ID" and "App Secret".

> ℹ️ **Note**
> 应用不发布版本，所获取的「AppID」、「AppSecret」 均无法使用，或请求错误。
:::note
For non-enterprise internal use, you also need to click "Create a version" button in "Version Management and Release" page.
The "App ID" and "App Secret" will only take effect after the application status changes to "Enabled."
:::
26 changes: 13 additions & 13 deletions ...ocusaurus-plugin-content-docs/current/integrations/social/feishu-web/README.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,25 +10,25 @@ import GuideTip from '../../fragments/_guide-tip.mdx';

# Soziale Anmeldung mit Feishu einrichten

飞书网页: 先进企业协作与管理平台，一站式无缝办公协作，团队上下对齐目标，全面激活组织和个人。
Feishu Web: Eine fortschrittliche Unternehmens-Kollaborations- und Managementplattform, die nahtlose Bürokooperation bietet und Teamziele ausrichtet, um Organisationen und Einzelpersonen vollständig zu aktivieren.

<GuideTip />

## 开始上手 \{#开始上手}
## Einstieg in die soziale Anmeldung mit Feishu \{#getting-started-with-feishu-social-sign-in}

Der Feishu-Web-Connector ist für Desktop-Webanwendungen konzipiert. Er verwendet den OAuth 2.0 Authentifizierungsprozess.
Der Feishu-Web-Connector ist für Desktop-Webanwendungen konzipiert und verwendet den OAuth 2.0-Authentifizierungsprozess.

## 注册飞书开发者账号 \{#注册飞书开发者账号}
## Ein Feishu-Entwicklerkonto registrieren \{#register-a-feishu-developer-account}

Falls du noch kein Feishu-Entwicklerkonto hast, registriere dich bitte auf der [offenen Plattform](https://open.feishu.cn/?lang=zh-CN).
Falls du noch kein Feishu-Entwicklerkonto hast, registriere dich bitte auf der [Feishu Open Platform](https://open.feishu.cn/app).

## 创建应用 \{#创建应用}
## Eine Anwendung erstellen \{#create-an-application}

1. Auf der [Entwickler-Startseite](https://open.feishu.cn/app?lang=zh-CN) unten gibt es die Option „企业自建应用 erstellen“
2. Gib den Anwendungsnamen ein, wähle „企业自建应用“ und klicke auf „应用 erstellen“
3. Füge in den „Sicherheitseinstellungen“ auf der linken Seite die entsprechende „重定向 URL“ `${your_logto_origin}/callback/${connector_id}` hinzu. Der `connector_id` kann auf der Detailseite des Connectors gefunden werden, nachdem der entsprechende Connector im Verwaltungs-Dashboard hinzugefügt wurde
4. Unter „凭证与基本信息“ auf der linken Seite kannst du „AppID“ und „AppSecret“ erhalten
5. Unter „应用发布“ auf der linken Seite muss die erste Version veröffentlicht werden, damit „AppID“ und „AppSecret“ wirksam werden
1. Klicke im [Entwicklerkonsole](https://open.feishu.cn/app) auf "Benutzerdefinierte App erstellen".
2. Gib den Anwendungsnamen und die Beschreibung ein, wähle ein Symbol aus und klicke auf die Schaltfläche "Erstellen".
3. Klicke im linken Menü auf "Sicherheitseinstellungen" und gib die "Redirect URL" als `${logto_endpoint}/callback/${connector_id}` ein. Der entsprechende Wert kann im Feld `Callback URI` auf der Detailseite des Feishu-Connectors in der Logto-Konsole gefunden werden.
4. Unter "Anmeldeinformationen & Basisinformationen" kannst du die "App ID" und "App Secret" erhalten.

> ℹ️ **Hinweis**
> Wenn keine Version der Anwendung veröffentlicht wird, können die erhaltenen „AppID“ und „AppSecret“ nicht verwendet werden oder es treten Fehler bei Anfragen auf.
:::note
Für die nicht-interne Verwendung im Unternehmen musst du auch im Menü "Versionsverwaltung und Veröffentlichung" auf die Schaltfläche "Version erstellen" klicken. Die "App ID" und "App Secret" werden erst wirksam, nachdem der Anwendungsstatus auf "Aktiviert" geändert wurde.
:::
26 changes: 13 additions & 13 deletions ...ocusaurus-plugin-content-docs/current/integrations/social/feishu-web/README.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,25 +10,25 @@ import GuideTip from '../../fragments/_guide-tip.mdx';

# Configura el inicio de sesión social con Feishu

飞书网页: Plataforma avanzada de colaboración y gestión empresarial, colaboración de oficina sin fisuras en una sola parada, alineación de objetivos de equipo de arriba a abajo, activación completa de la organización y el individuo.
Feishu Web: Una plataforma avanzada de colaboración y gestión empresarial, que ofrece colaboración de oficina sin fisuras y alinea los objetivos del equipo para activar completamente organizaciones e individuos.

<GuideTip />

## Comenzar \{#开始上手}
## Comenzar con el inicio de sesión social de Feishu \{#getting-started-with-feishu-social-sign-in}

El conector de Feishu Web está diseñado para aplicaciones web de escritorio. Adopta el flujo de autenticación OAuth 2.0.
El conector de Feishu Web está diseñado para aplicaciones web de escritorio y utiliza el proceso de autenticación OAuth 2.0.

## Registra una cuenta de desarrollador de Feishu \{#注册飞书开发者账号}
## Registrar una cuenta de desarrollador de Feishu \{#register-a-feishu-developer-account}

Si aún no tienes una cuenta de desarrollador de Feishu, regístrate en la [plataforma abierta](https://open.feishu.cn/?lang=zh-CN).
Si aún no tienes una cuenta de desarrollador de Feishu, regístrate en la [Feishu Open Platform](https://open.feishu.cn/app).

## Crear una aplicación \{#创建应用}
## Crear una aplicación \{#create-an-application}

1. En la [página de inicio del desarrollador](https://open.feishu.cn/app?lang=zh-CN), haz clic en "Crear aplicación empresarial autoconstruida".
2. Completa el nombre de la aplicación, selecciona "Aplicación empresarial autoconstruida" y haz clic en "Crear aplicación".
3. En "Configuración de seguridad" a la izquierda, añade la "URL de redirección" correspondiente `${your_logto_origin}/callback/${connector_id}`. El `connector_id` se puede encontrar en la página de detalles del conector después de haber añadido el conector correspondiente en el panel de administración.
4. En "Credenciales e información básica" a la izquierda, puedes obtener el "AppID" y "AppSecret".
5. En "Publicación de la aplicación" a la izquierda, necesitas publicar la primera versión para que el "AppID" y "AppSecret" sean efectivos.
1. En la [Consola de Desarrolladores](https://open.feishu.cn/app), haz clic en "Crear aplicación personalizada".
2. Completa el nombre de la aplicación, la descripción, selecciona un icono y haz clic en el botón "Crear".
3. En la barra lateral izquierda, haz clic en "Configuración de seguridad" y llena la "URL de redirección" como `${logto_endpoint}/callback/${connector_id}`. El valor correspondiente se puede encontrar en el campo `Callback URI` en la página de detalles del conector Feishu en la Consola Logto.
4. En "Credenciales e Información Básica", puedes obtener el "App ID" y "App Secret".

> ℹ️ **Nota**
> Si la aplicación no publica una versión, el "AppID" y "AppSecret" obtenidos no se podrán usar o se producirá un error en la solicitud.
:::note
Para uso no interno de la empresa, también necesitas hacer clic en el botón "Crear una versión" en la página "Gestión y publicación de versiones". El "App ID" y "App Secret" solo serán efectivos después de que el estado de la aplicación cambie a "Habilitado".
:::
26 changes: 13 additions & 13 deletions ...ocusaurus-plugin-content-docs/current/integrations/social/feishu-web/README.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,25 +10,25 @@ import GuideTip from '../../fragments/_guide-tip.mdx';

# Configurer la connexion sociale avec Feishu

飞书网页 : 先进企业协作与管理平台，一站式无缝办公协作，团队上下对齐目标，全面激活组织和个人。
Feishu Web : Une plateforme avancée de collaboration et de gestion d'entreprise, offrant une collaboration bureautique sans faille et alignant les objectifs de l'équipe pour activer pleinement les organisations et les individus.

<GuideTip />

## 开始上手 \{#开始上手}
## Commencer avec la connexion sociale Feishu \{#getting-started-with-feishu-social-sign-in}

Le connecteur Feishu Web est conçu pour les applications Web de bureau. Il utilise le processus d'Authentification OAuth 2.0.
Le connecteur Feishu Web est conçu pour les applications Web de bureau et utilise le processus d'authentification OAuth 2.0.

## 注册飞书开发者账号 \{#注册飞书开发者账号}
## Enregistrer un compte développeur Feishu \{#register-a-feishu-developer-account}

Si vous n'avez pas encore de compte développeur Feishu, veuillez vous inscrire sur la [plateforme ouverte](https://open.feishu.cn/?lang=zh-CN).
Si vous n'avez pas encore de compte développeur Feishu, veuillez vous inscrire sur la [Feishu Open Platform](https://open.feishu.cn/app).

## 创建应用 \{#创建应用}
## Créer une application \{#create-an-application}

1. En bas de la [page d'accueil des développeurs](https://open.feishu.cn/app?lang=zh-CN), il y a « 创建企业自建应用 »
2. Remplissez le nom de l'application, choisissez « 企业自建应用 », puis cliquez sur « 创建应用 »
3. Dans les « 安全设置中 » à gauche, ajoutez l'« URL de redirection » appropriée `${your_logto_origin}/callback/${connector_id}`. Le `connector_id` peut être trouvé sur la page de détails du connecteur après avoir ajouté le connecteur correspondant dans la console de gestion
4. Dans « 凭证与基本信息 » à gauche, vous pouvez obtenir l'« AppID » et l'« AppSecret »
5. Dans « 应用发布 » à gauche, vous devez publier la première version pour que l'« AppID » et l'« AppSecret » prennent effet
1. Dans la [Console Développeur](https://open.feishu.cn/app), cliquez sur "Créer une application personnalisée".
2. Remplissez le nom de l'application, la description, sélectionnez une icône et cliquez sur le bouton "Créer".
3. Dans la barre latérale gauche, cliquez sur "Paramètres de sécurité" et remplissez l'"URL de redirection" comme `${logto_endpoint}/callback/${connector_id}`. La valeur correspondante peut être trouvée dans le champ `Callback URI` sur la page de détails du connecteur Feishu dans la Console Logto.
4. Dans "Informations d'identification et informations de base", vous pouvez obtenir l'"App ID" et l'"App Secret".

> ℹ️ **Remarque**
> Si l'application ne publie pas de version, l'« AppID » et l'« AppSecret » obtenus ne peuvent pas être utilisés ou la requête échouera.
:::note
Pour une utilisation non interne à l'entreprise, vous devez également cliquer sur le bouton "Créer une version" sur la page "Gestion et publication des versions". L'"App ID" et l'"App Secret" ne seront effectifs qu'après que le statut de l'application ait changé pour "Activé".
:::
28 changes: 14 additions & 14 deletions ...ocusaurus-plugin-content-docs/current/integrations/social/feishu-web/README.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,27 +8,27 @@ sidebar_custom_props:

import GuideTip from '../../fragments/_guide-tip.mdx';

# Feishu を使用してソーシャルログインを設定する
# Feishu を使用してソーシャルサインインを設定する

飞书网页: 先进企业协作与管理平台，一站式无缝办公协作，团队上下对齐目标，全面激活组织和个人。
Feishu Web: 先進的な企業向けコラボレーションおよび管理プラットフォームであり、シームレスなオフィスコラボレーションを提供し、チームの目標を調整して組織と個人を完全に活性化します。

<GuideTip />

## 開始する \{#开始上手}
## Feishu ソーシャルサインインを開始する \{#getting-started-with-feishu-social-sign-in}

飞书网页コネクターはデスクトップウェブアプリケーション向けに設計されています。OAuth 2.0 認証 (Authentication) フローを採用しています。
Feishu コネクタはデスクトップウェブアプリケーション向けに設計されており、OAuth 2.0 認証プロセスを使用します。

## Feishu 開発者アカウントを登録する \{#注册飞书开发者账号}
## Feishu 開発者アカウントを登録する \{#register-a-feishu-developer-account}

まだ Feishu 開発者アカウントをお持ちでない場合は、[开放平台](https://open.feishu.cn/?lang=zh-CN) で登録してください。
まだ Feishu 開発者アカウントをお持ちでない場合は、[Feishu オープンプラットフォーム](https://open.feishu.cn/app) で登録してください。

## アプリを作成する \{#创建应用}
## アプリを作成する \{#create-an-application}

1. [开发者首页](https://open.feishu.cn/app?lang=zh-CN) の下に「创建企业自建应用」があります。
2. アプリ名を入力し、「企业自建应用」を選択して「创建应用」をクリックします。
3. 左側の「安全设置中」で適切な「重定向 URL」 `${your_logto_origin}/callback/${connector_id}` を追加します。`connector_id` は管理コンソールで対応するコネクターを追加した後、コネクターの詳細ページで見つけることができます。
4. 左側の「凭证与基本信息」で「AppID」、「AppSecret」を取得できます。
5. 左側の「应用发布」で最初のバージョンを公開する必要があります。「AppID」、「AppSecret」はその後で有効になります。
1. [開発者コンソール](https://open.feishu.cn/app) で「カスタムアプリを作成」をクリックします。
2. アプリ名、説明を入力し、アイコンを選択して「作成」ボタンをクリックします。
3. 左側のサイドバーで「セキュリティ設定」をクリックし、「リダイレクト URL」として `${logto_endpoint}/callback/${connector_id}` を入力します。対応する値は Logto コンソールの Feishu コネクタ詳細ページの `Callback URI` フィールドにあります。
4. 「認証情報と基本情報」で「App ID」と「App Secret」を取得できます。

> ℹ️ **Note**
> アプリをバージョン公開しないと、取得した「AppID」、「AppSecret」は使用できず、リクエストエラーが発生します。
:::note
企業内での使用でない場合は、「バージョン管理とリリース」ページで「バージョンを作成」ボタンをクリックする必要があります。「App ID」と「App Secret」は、アプリケーションのステータスが「有効」に変更された後にのみ有効になります。
:::
26 changes: 13 additions & 13 deletions ...ocusaurus-plugin-content-docs/current/integrations/social/feishu-web/README.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,25 +10,25 @@ import GuideTip from '../../fragments/_guide-tip.mdx';

# Configurar login social com Feishu

飞书网页: Plataforma avançada de colaboração e gestão empresarial, colaboração de escritório sem costura em uma única parada, alinhamento de metas de equipe de cima para baixo, ativação completa de organizações e indivíduos.
Feishu Web: Uma plataforma avançada de colaboração e gestão empresarial, que oferece colaboração de escritório sem costura e alinha os objetivos da equipe para ativar completamente organizações e indivíduos.

<GuideTip />

## Começando \{#开始上手}
## Começando com o login social do Feishu \{#getting-started-with-feishu-social-sign-in}

O conector Feishu é projetado para aplicativos web de desktop. Ele adota o fluxo de autenticação OAuth 2.0.
O conector Feishu é projetado para aplicativos web de desktop e utiliza o processo de autenticação OAuth 2.0.

## Registrar uma conta de desenvolvedor Feishu \{#注册飞书开发者账号}
## Registrar uma conta de desenvolvedor Feishu \{#register-a-feishu-developer-account}

Se você ainda não tem uma conta de desenvolvedor Feishu, registre-se na [plataforma aberta](https://open.feishu.cn/?lang=zh-CN).
Se você ainda não tem uma conta de desenvolvedor Feishu, registre-se na [Feishu Open Platform](https://open.feishu.cn/app).

## Criar um aplicativo \{#创建应用}
## Criar um aplicativo \{#create-an-application}

1. Na [página inicial do desenvolvedor](https://open.feishu.cn/app?lang=zh-CN), clique em "Criar aplicativo autônomo da empresa"
2. Preencha o nome do aplicativo, selecione "Aplicativo autônomo da empresa" e clique em "Criar aplicativo"
3. No menu à esquerda, em "Configurações de segurança", adicione a "URL de redirecionamento" correspondente `${your_logto_origin}/callback/${connector_id}`. O `connector_id` pode ser encontrado na página de detalhes do conector após adicioná-lo no console de gerenciamento
4. No menu à esquerda, em "Credenciais e informações básicas", você pode obter o "AppID" e "AppSecret"
5. No menu à esquerda, em "Publicação do aplicativo", é necessário publicar a primeira versão para que o "AppID" e "AppSecret" sejam efetivos
1. Na [Console do Desenvolvedor](https://open.feishu.cn/app), clique em "Criar aplicativo personalizado".
2. Preencha o nome do aplicativo, a descrição, selecione um ícone e clique no botão "Criar".
3. Na barra lateral esquerda, clique em "Configurações de segurança" e preencha a "URL de redirecionamento" como `${logto_endpoint}/callback/${connector_id}`. O valor correspondente pode ser encontrado no campo `Callback URI` na página de detalhes do conector Feishu na Console Logto.
4. Em "Credenciais e Informações Básicas", você pode obter o "App ID" e "App Secret".

> ℹ️ **Nota**
> Se o aplicativo não publicar uma versão, o "AppID" e "AppSecret" obtidos não poderão ser usados ou resultarão em erro de solicitação.
:::note
Para uso não interno da empresa, você também precisa clicar no botão "Criar uma versão" na página "Gerenciamento e publicação de versões". O "App ID" e "App Secret" só serão efetivos após o status do aplicativo mudar para "Ativado".
:::
Loading

0 comments on commit 6cb7240

Please sign in to comment.