From 1a0aff3990c9da0963a71a33591d2db48d634077 Mon Sep 17 00:00:00 2001 From: Kevin Bhunut Date: Wed, 21 Nov 2018 10:51:38 -0800 Subject: [PATCH] Ergonomic tweaks to template configs --- docs/bp/success-guide/command_line_options.md | 2 +- docs/bp/success-guide/setup_config_files.md | 2 +- docs/bp/user-manual/usage_scenarios.md | 2 +- docs/de/success-guide/command_line_options.md | 2 +- docs/de/success-guide/setup_config_files.md | 2 +- docs/de/user-manual/usage_scenarios.md | 2 +- docs/en/success-guide/command_line_options.md | 2 +- docs/en/success-guide/setup_config_files.md | 2 +- docs/en/user-manual/usage_scenarios.md | 2 +- docs/es/success-guide/command_line_options.md | 2 +- docs/es/success-guide/setup_config_files.md | 2 +- docs/es/user-manual/usage_scenarios.md | 2 +- docs/fr/success-guide/command_line_options.md | 2 +- docs/fr/success-guide/setup_config_files.md | 2 +- docs/fr/user-manual/usage_scenarios.md | 2 +- docs/jp/success-guide/command_line_options.md | 2 +- docs/jp/success-guide/setup_config_files.md | 2 +- docs/jp/user-manual/usage_scenarios.md | 2 +- ...{4 connector-csv.yml => connector-csv.yml} | 0 ... connector-ldap.yml => connector-ldap.yml} | 10 ++--- ... connector-okta.yml => connector-okta.yml} | 0 ...onnector-umapi.yml => connector-umapi.yml} | 2 +- ...r-sync-config.yml => user-sync-config.yml} | 37 +++++++++---------- ...ension-config.yml => extension-config.yml} | 0 .../{3 remove-list.csv => remove-list.csv} | 0 ...e-with-custom-attributes-and-mappings.csv} | 0 .../{1 users-file.csv => users-file.csv} | 0 27 files changed, 41 insertions(+), 44 deletions(-) rename examples/config files - basic/{4 connector-csv.yml => connector-csv.yml} (100%) rename examples/config files - basic/{3 connector-ldap.yml => connector-ldap.yml} (97%) rename examples/config files - basic/{5 connector-okta.yml => connector-okta.yml} (100%) rename examples/config files - basic/{2 connector-umapi.yml => connector-umapi.yml} (98%) rename examples/config files - basic/{1 user-sync-config.yml => user-sync-config.yml} (94%) rename examples/config files - custom attributes and mappings/{1 extension-config.yml => extension-config.yml} (100%) rename examples/csv inputs - user and remove lists/{3 remove-list.csv => remove-list.csv} (100%) rename examples/csv inputs - user and remove lists/{2 users-file-with-custom-attributes-and-mappings.csv => users-file-with-custom-attributes-and-mappings.csv} (100%) rename examples/csv inputs - user and remove lists/{1 users-file.csv => users-file.csv} (100%) diff --git a/docs/bp/success-guide/command_line_options.md b/docs/bp/success-guide/command_line_options.md index 56b65bf19..9dff09476 100644 --- a/docs/bp/success-guide/command_line_options.md +++ b/docs/bp/success-guide/command_line_options.md @@ -26,7 +26,7 @@ A linha de comando do User Sync seleciona o conjunto de usuários a ser processa Se todos os usuários listados no diretório precisarem ser sincronizados com a Adobe, use `--users all`. Se forem apenas alguns usuários, você poderá limitar o conjunto alterando a consulta LDAP no arquivo de configuração `connector-ldap.yml` (e usar `--users all`) ou limitar os usuários àqueles em grupos específicos (usando --grupo de usuários). Você pode combinar uma dessas opções com `--user-filter pattern` para limitar ainda mais o conjunto selecionado de usuários a ser sincronizado. -Se você não estiver usando um sistema de diretórios, poderá usar `--users file f` para selecionar os usuários de um arquivo csv. Consulte o arquivo de exemplos de usuários (`csv inputs - user and remove lists/1 users-file.csv`) para ver o formato. Os grupos listados nos arquivos csv são nomes que podem ser selecionados. Eles são mapeados para os grupos de usuários ou PCs da Adobe do mesmo modo que com os grupos de diretórios. +Se você não estiver usando um sistema de diretórios, poderá usar `--users file f` para selecionar os usuários de um arquivo csv. Consulte o arquivo de exemplos de usuários (`csv inputs - user and remove lists/users-file.csv`) para ver o formato. Os grupos listados nos arquivos csv são nomes que podem ser selecionados. Eles são mapeados para os grupos de usuários ou PCs da Adobe do mesmo modo que com os grupos de diretórios. ## Grupos diff --git a/docs/bp/success-guide/setup_config_files.md b/docs/bp/success-guide/setup_config_files.md index e93ad15e3..a09d2111c 100644 --- a/docs/bp/success-guide/setup_config_files.md +++ b/docs/bp/success-guide/setup_config_files.md @@ -32,7 +32,7 @@ Nas etapas anteriores, você configurou um diretório de sistema de arquivos par ### Arquivo de configuração de acesso ao diretório -Se você estiver executando o User Sync de um arquivo, poderá ignorar a configuração de connector-ldap.yml e criar um arquivo csv com toda a sua lista de usuários seguindo o exemplo do arquivo “csv inputs - user and remove lists/1 users-file.csv”. Esse arquivo está no download do example-configurations.tar.gz da versão. +Se você estiver executando o User Sync de um arquivo, poderá ignorar a configuração de connector-ldap.yml e criar um arquivo csv com toda a sua lista de usuários seguindo o exemplo do arquivo “csv inputs - user and remove lists/users-file.csv”. Esse arquivo está no download do example-configurations.tar.gz da versão. ☐ Edite o arquivo connector-ldap.yml. Ele tem informações de acesso para o sistema de diretório. Insira valores de nome de usuário, senha, host e base_dn. diff --git a/docs/bp/user-manual/usage_scenarios.md b/docs/bp/user-manual/usage_scenarios.md index f671b6e33..30acf3632 100644 --- a/docs/bp/user-manual/usage_scenarios.md +++ b/docs/bp/user-manual/usage_scenarios.md @@ -191,7 +191,7 @@ estão marcados para remoção em um arquivo CSV. Para realizar as remoções em uma chamada separada, é possível enviar o arquivo gerado pelo parâmetro `--adobe-only-user-action write-file`, ou enviar um arquivo CSV de usuários gerado de -outra maneira. Um exemplo de tal arquivo, `3 remove-list.csv`, +outra maneira. Um exemplo de tal arquivo, `remove-list.csv`, é fornecido no arquivo example-configurations.tar.gz na pasta `csv inputs - user and remove lists`. #### Adicionar usuários e gerar uma lista de usuários para remoção diff --git a/docs/de/success-guide/command_line_options.md b/docs/de/success-guide/command_line_options.md index 149b8c7f4..8d257225f 100644 --- a/docs/de/success-guide/command_line_options.md +++ b/docs/de/success-guide/command_line_options.md @@ -26,7 +26,7 @@ nav_order: 310 Wenn Sie alle im Verzeichnis aufgelisteten Benutzer mit Adobe synchronisieren möchten, verwenden Sie die Option `--users all`. Wenn die Synchronisation nur einige Benutzer betreffen soll, können Sie die Auswahl eingrenzen, indem Sie die LDAP-Abfrage in der Konfigurationsdatei „connector-ldap.yml“ ändern (und die Option `--users all` verwenden). Sie können die Benutzerauswahl auch über die Gruppenmitgliedschaft (mit „--users group“) beschränken. Bei beiden Befehlen können Sie mit der Option `--user-filter pattern` die Auswahl der zu synchronisierenden Benutzer weiter eingrenzen. -Wenn Sie kein Verzeichnissystem verwenden, können Sie die Benutzer mit dem Befehl `--users file f` aus einer CSV-Datei auslesen. Welches Format Sie dazu verwenden, sehen Sie in der Beispieldatei mit Benutzern („csv inputs - user and remove lists/1 users-file.csv“). Die in CSV-Dateien aufgeführten Gruppen stellen die Namen dar, aus den Sie wählen können. Die Zuordnung zu Adobe-Benutzergruppen oder Produktkonfigurationen entspricht der Zuordnung zu Verzeichnisgruppen. +Wenn Sie kein Verzeichnissystem verwenden, können Sie die Benutzer mit dem Befehl `--users file f` aus einer CSV-Datei auslesen. Welches Format Sie dazu verwenden, sehen Sie in der Beispieldatei mit Benutzern („csv inputs - user and remove lists/users-file.csv“). Die in CSV-Dateien aufgeführten Gruppen stellen die Namen dar, aus den Sie wählen können. Die Zuordnung zu Adobe-Benutzergruppen oder Produktkonfigurationen entspricht der Zuordnung zu Verzeichnisgruppen. ## Gruppen diff --git a/docs/de/success-guide/setup_config_files.md b/docs/de/success-guide/setup_config_files.md index ecd9ba31d..2647c4240 100644 --- a/docs/de/success-guide/setup_config_files.md +++ b/docs/de/success-guide/setup_config_files.md @@ -32,7 +32,7 @@ Sie haben in den vorherigen Schritten ein Dateisystemverzeichnis für den Python ### Konfigurationsdatei für den Verzeichniszugriff -Wenn Sie das Benutzer-Synchronisationstool über eine Datei ausführen, können Sie das Einrichten von connector-ldap.yml überspringen und stattdessen wie im Beispiel mit der Datei „csv inputs - user and remove lists/1 users-file.csv“ eine CSV-Datei mit der gesamten Benutzerliste erstellen. Diese Datei befindet sich im Download „example-configurations.tar.gz“ des Release. +Wenn Sie das Benutzer-Synchronisationstool über eine Datei ausführen, können Sie das Einrichten von connector-ldap.yml überspringen und stattdessen wie im Beispiel mit der Datei „csv inputs - user and remove lists/users-file.csv“ eine CSV-Datei mit der gesamten Benutzerliste erstellen. Diese Datei befindet sich im Download „example-configurations.tar.gz“ des Release. ☐ Bearbeiten Sie die Datei „connector-ldap.yml“. Diese Datei enthält Informationen für den Zugriff auf das Verzeichnissystem. Geben Sie Werte für Benutzername, Kennwort, Host und Basis-DN ein. diff --git a/docs/de/user-manual/usage_scenarios.md b/docs/de/user-manual/usage_scenarios.md index b4c7411c0..8a0b3657d 100644 --- a/docs/de/user-manual/usage_scenarios.md +++ b/docs/de/user-manual/usage_scenarios.md @@ -125,7 +125,7 @@ Wenn Sie den Parameter `--adobe-only-user-action` nicht angeben, können Sie Ben Wenn Sie Entfernungen separat behandeln möchten, können Sie das Tool anweisen, Benutzer zu kennzeichnen, die nicht mehr im Unternehmensverzeichnis, jedoch immer noch auf Adobe-Seite vorhanden sind. Der Parameter `--adobe-only-user-action write-file exiting-users.csv` schreibt die Liste der zum Entfernen gekennzeichneten Benutzer in eine CSV-Datei. -Um die Entfernungen in einem separaten Aufruf auszuführen, können Sie die durch den Parameter `--adobe-only-user-action write-file` generierte Datei übergeben oder Sie können eine CSV-Datei mit Benutzern übergeben, die auf andere Weise generiert wurde. Ein Beispiel für eine solche Datei, `3 remove-list.csv`, wird in der Datei „example-configurations.tar.gz“ im Ordner `csv inputs - user and remove lists` bereitgestellt. +Um die Entfernungen in einem separaten Aufruf auszuführen, können Sie die durch den Parameter `--adobe-only-user-action write-file` generierte Datei übergeben oder Sie können eine CSV-Datei mit Benutzern übergeben, die auf andere Weise generiert wurde. Ein Beispiel für eine solche Datei, `remove-list.csv`, wird in der Datei „example-configurations.tar.gz“ im Ordner `csv inputs - user and remove lists` bereitgestellt. #### Benutzer hinzufügen und eine Liste mit zu entfernenden Benutzern generieren diff --git a/docs/en/success-guide/command_line_options.md b/docs/en/success-guide/command_line_options.md index 8140b1c30..63fc54906 100644 --- a/docs/en/success-guide/command_line_options.md +++ b/docs/en/success-guide/command_line_options.md @@ -27,7 +27,7 @@ The command line for user sync selects the set of users to be processed, specifi If all users listed in the directory are to be synced to Adobe, use `--users all`. If only some users, you can limit the set by altering the LDAP query in the `connector-ldap.yml` configuration file (and use `--users all`), or you can limit the users to those in specific groups (by using --users group). You can combine either of these with a `--user-filter pattern` to further limit the selected set of users to be synced. -If you are not using a directory system, you can use `--users file f` to select users from a csv file. See the example users file (`csv inputs - user and remove lists/1 users-file.csv`) to see the format. Groups listed in the csv files are names you can choose. They are mapped to Adobe user groups or PCs in the same manner as with directory groups. +If you are not using a directory system, you can use `--users file f` to select users from a csv file. See the example users file (`csv inputs - user and remove lists/users-file.csv`) to see the format. Groups listed in the csv files are names you can choose. They are mapped to Adobe user groups or PCs in the same manner as with directory groups. ## Groups diff --git a/docs/en/success-guide/setup_config_files.md b/docs/en/success-guide/setup_config_files.md index 3035e2220..f173106f9 100644 --- a/docs/en/success-guide/setup_config_files.md +++ b/docs/en/success-guide/setup_config_files.md @@ -32,7 +32,7 @@ In previous steps, you set up a file system directory for the user sync tool Pyt ### Directory Access Configuration File -If you are driving User Sync from a file, you can skip setting up connector-ldap.yml and instead create a csv file with your entire user list following the "csv inputs - user and remove lists/1 users-file.csv" file example. This file is in the example-configurations.tar.gz download from the release. +If you are driving User Sync from a file, you can skip setting up connector-ldap.yml and instead create a csv file with your entire user list following the "csv inputs - user and remove lists/users-file.csv" file example. This file is in the example-configurations.tar.gz download from the release. ☐ Edit the file connector-ldap.yml. This file has access information to the directory system. Put in username, password, host, and base_dn values. diff --git a/docs/en/user-manual/usage_scenarios.md b/docs/en/user-manual/usage_scenarios.md index 42d5601c6..fc8e0995c 100644 --- a/docs/en/user-manual/usage_scenarios.md +++ b/docs/en/user-manual/usage_scenarios.md @@ -190,7 +190,7 @@ are flagged for removal to a CSV file. To perform the removals in a separate call, you can pass the file generated by the `--adobe-only-user-action write-file` parameter, or you can pass a CSV file of users that you have generated by some -other means. An example of such a file, `3 remove-list.csv`, +other means. An example of such a file, `remove-list.csv`, is provided in the example-configurations.tar.gz file in the `csv inputs - user and remove lists` folder. #### Add users and generate a list of users to remove diff --git a/docs/es/success-guide/command_line_options.md b/docs/es/success-guide/command_line_options.md index 538de88c6..472b29db0 100644 --- a/docs/es/success-guide/command_line_options.md +++ b/docs/es/success-guide/command_line_options.md @@ -26,7 +26,7 @@ La línea de comandos de User Sync selecciona el conjunto de los usuarios que se Si todos los usuarios que aparecen en el directorio deben sincronizarse con Adobe, utilice `--users all`. Si son solo algunos usuarios, puede limitar el conjunto modificando la consulta LDAP en el archivo de configuración 'connector-ldap.yml' (y utilizar `--users all`), o puede limitar los usuarios a aquellos que se encuentran en los grupos específicos (utilizando -- grupo de usuarios). Puede combinar cualquiera de estas opciones con un `--user-filter pattern` para limitar más el conjunto seleccionado de usuarios que se sincronizarán. -Si no utiliza un sistema de directorio, puede utilizar `--users file f` para seleccionar los usuarios de un archivo csv. Consulte el archivo de usuarios de ejemplo (`csv inputs - user and remove lists/1 users-file.csv`) para ver el formato. Los grupos que aparecen en los archivos csv son nombres que puede elegir. Se asignan a grupos de usuarios o configuraciones de productos de Adobe de la misma forma que con los grupos de directorio. +Si no utiliza un sistema de directorio, puede utilizar `--users file f` para seleccionar los usuarios de un archivo csv. Consulte el archivo de usuarios de ejemplo (`csv inputs - user and remove lists/users-file.csv`) para ver el formato. Los grupos que aparecen en los archivos csv son nombres que puede elegir. Se asignan a grupos de usuarios o configuraciones de productos de Adobe de la misma forma que con los grupos de directorio. ## Grupos diff --git a/docs/es/success-guide/setup_config_files.md b/docs/es/success-guide/setup_config_files.md index 017a29cef..cb60f81bd 100644 --- a/docs/es/success-guide/setup_config_files.md +++ b/docs/es/success-guide/setup_config_files.md @@ -32,7 +32,7 @@ En los pasos anteriores, ha configurado un directorio de sistema de archivos del ### Archivo de configuración de acceso al directorio -Si ejecuta User Sync desde un archivo, puede omitir la configuración de connector-ldap.yml y, en lugar de eso, crear un archivo csv con la lista de usuario completa siguiendo el ejemplo de archivo “csv inputs - user and remove lists/1 users-file.csv”. Este archivo se encuentra en la descarga de example-configurations.tar.gz de la versión. +Si ejecuta User Sync desde un archivo, puede omitir la configuración de connector-ldap.yml y, en lugar de eso, crear un archivo csv con la lista de usuario completa siguiendo el ejemplo de archivo “csv inputs - user and remove lists/users-file.csv”. Este archivo se encuentra en la descarga de example-configurations.tar.gz de la versión. ☐ Edite el archivo connector-ldap.yml. Este archivo tiene información de acceso al sistema de directorio. Introduzca los valores de nombre de usuario, contraseña, host y base_dn. diff --git a/docs/es/user-manual/usage_scenarios.md b/docs/es/user-manual/usage_scenarios.md index f5753d35b..f301b029f 100644 --- a/docs/es/user-manual/usage_scenarios.md +++ b/docs/es/user-manual/usage_scenarios.md @@ -124,7 +124,7 @@ Si no proporciona el parámetro `--adobe-only-user-action`, puede sincronizar lo Si desea gestionar las eliminaciones por separado, puede indicar a la herramienta que marque los usuarios que ya no existen en el directorio de empresa, pero todavía existen en la parte de Adobe. El parámetro `--adobe-only-user-action write-file exiting-users.csv` escribe la lista de los usuarios marcados para la eliminación en un archivo CSV. -Para realizar las eliminaciones en una ejecución separada, puede pasar el archivo generado por el parámetro `--adobe-only-user-action write-file` o pasar un archivo CSV de usuarios que ha generado por otros medios. Se ofrece un ejemplo de un archivo de este tipo, `3 remove-list.csv`, en el archivo example-configurations.tar.gz de la carpeta `csv inputs - user and remove lists`. +Para realizar las eliminaciones en una ejecución separada, puede pasar el archivo generado por el parámetro `--adobe-only-user-action write-file` o pasar un archivo CSV de usuarios que ha generado por otros medios. Se ofrece un ejemplo de un archivo de este tipo, `remove-list.csv`, en el archivo example-configurations.tar.gz de la carpeta `csv inputs - user and remove lists`. #### Añadir usuarios y generar una lista de usuarios para eliminar diff --git a/docs/fr/success-guide/command_line_options.md b/docs/fr/success-guide/command_line_options.md index 680ce447c..570fc399e 100644 --- a/docs/fr/success-guide/command_line_options.md +++ b/docs/fr/success-guide/command_line_options.md @@ -26,7 +26,7 @@ La ligne de commande de l’outil User Sync sélectionne l’ensemble des utilis Si tous les utilisateurs qui figurent dans l’annuaire doivent être synchronisés avec Adobe, utilisez `--users all`. Si vous souhaitez seulement synchroniser certains utilisateurs, vous pouvez limiter l’ensemble en modifiant la requête LDAP dans le fichier de configuration connector-ldap.yml (et utiliser `--users all`). Vous pouvez également limiter les utilisateurs à ceux appartenant à des groupes spécifiques (à l’aide de --users group). Vous pouvez combiner l’un ou l’autre avec un motif `--user-filter pattern` de façon à limiter la sélection d’utilisateurs à synchroniser. -Si vous n’utilisez pas de système d’annuaire, vous pouvez utiliser `--users file f` pour sélectionner les utilisateurs à partir d’un fichier CSV. Reportez-vous à l’exemple de fichier d’utilisateurs (csv inputs - user and remove lists/1 users-file.csv) pour observer le format. Vous pouvez choisir les noms des groupes figurant dans les fichiers CSV. Ils sont mappés aux groupes d’utilisateurs et aux configurations de produits Adobe de la même manière que les groupes d’annuaire. +Si vous n’utilisez pas de système d’annuaire, vous pouvez utiliser `--users file f` pour sélectionner les utilisateurs à partir d’un fichier CSV. Reportez-vous à l’exemple de fichier d’utilisateurs (csv inputs - user and remove lists/users-file.csv) pour observer le format. Vous pouvez choisir les noms des groupes figurant dans les fichiers CSV. Ils sont mappés aux groupes d’utilisateurs et aux configurations de produits Adobe de la même manière que les groupes d’annuaire. ## Groupes diff --git a/docs/fr/success-guide/setup_config_files.md b/docs/fr/success-guide/setup_config_files.md index 5d0dfe79f..57af18e23 100644 --- a/docs/fr/success-guide/setup_config_files.md +++ b/docs/fr/success-guide/setup_config_files.md @@ -32,7 +32,7 @@ Dans les étapes précédentes, vous avez configuré un répertoire de système ### Fichier de configuration d’accès à l’annuaire -Si vous pilotez User Sync à partir d’un fichier, vous pouvez ignorer le paramétrage du fichier connector-ldap.yml et créer à la place un fichier CSV avec votre liste complète d’utilisateurs, comme dans l’exemple de fichier « csv inputs - user and remove lists/1 users-file.csv ». Ce fichier se trouve dans le téléchargement example-configurations.tar.gz. +Si vous pilotez User Sync à partir d’un fichier, vous pouvez ignorer le paramétrage du fichier connector-ldap.yml et créer à la place un fichier CSV avec votre liste complète d’utilisateurs, comme dans l’exemple de fichier « csv inputs - user and remove lists/users-file.csv ». Ce fichier se trouve dans le téléchargement example-configurations.tar.gz. ☐ Modifiez le fichier connector-ldap.yml. Celui-ci contient les informations d’accès au système d’annuaire. Indiquez les valeurs username (nom d’utilisateur), password (mot de passe), host (hôte) et base_dn (nom de domaine de base). diff --git a/docs/fr/user-manual/usage_scenarios.md b/docs/fr/user-manual/usage_scenarios.md index 51a078ae6..731893e9f 100644 --- a/docs/fr/user-manual/usage_scenarios.md +++ b/docs/fr/user-manual/usage_scenarios.md @@ -124,7 +124,7 @@ Si vous n’indiquez pas le paramètre `--adobe-only-user-action`, vous pouvez s Si vous souhaitez gérer les retraits séparément, vous pouvez indiquer à l’outil de signaler les utilisateurs qui n’existent plus dans l’annuaire de l’entreprise, mais existent toujours dans les systèmes Adobe. Le paramètre `--adobe-only-user-action write-file exiting-users.csv` écrit dans un fichier CSV la liste des utilisateurs qui sont signalés pour retrait. -Pour effectuer les retraits dans un appel distinct, vous pouvez transmettre le fichier généré par le paramètre `--adobe-only-user-action write-file`, ou bien transmettre un fichier CSV d’utilisateurs que vous avez généré d’une autre façon. Un exemple de ce type de fichier, `3 remove-list.csv`, est fourni dans le fichier example-configurations.tar.gz au sein du dossier `csv inputs - user and remove lists`. +Pour effectuer les retraits dans un appel distinct, vous pouvez transmettre le fichier généré par le paramètre `--adobe-only-user-action write-file`, ou bien transmettre un fichier CSV d’utilisateurs que vous avez généré d’une autre façon. Un exemple de ce type de fichier, `remove-list.csv`, est fourni dans le fichier example-configurations.tar.gz au sein du dossier `csv inputs - user and remove lists`. #### Ajouter des utilisateurs et générer une liste d’utilisateurs à retirer diff --git a/docs/jp/success-guide/command_line_options.md b/docs/jp/success-guide/command_line_options.md index b405c57a4..4808d7e6f 100644 --- a/docs/jp/success-guide/command_line_options.md +++ b/docs/jp/success-guide/command_line_options.md @@ -26,7 +26,7 @@ User Sync のコマンドラインでは、処理するユーザーのセット ディレクトリに一覧されているすべてのユーザーを Adobe と同期する場合は、`--users all` を使用します。一部のユーザーだけの場合は、`connector-ldap.yml` 構成ファイルで LDAP クエリを変更（また、`--users all` を使用）して設定を制限するか、（--users group を使用して）特定のグループ内のユーザーに制限することができます。これらのいずれかを `--user-filter pattern` と組み合わせて、同期するユーザーの選択したセットをさらに制限できます。 -ディレクトリシステムを使用していない場合は、`--users file f` を使用して csv ファイルからユーザーを選択できます。形式を確認するには、ユーザーファイルの例（csv inputs - user and remove lists/1 users-file.csv）を参照してください。csv ファイルに一覧されているグループは、選択できる名前です。これらは、ディレクトリグループと同じ方法で Adobe ユーザーグループや製品プロファイルにマップされます。 +ディレクトリシステムを使用していない場合は、`--users file f` を使用して csv ファイルからユーザーを選択できます。形式を確認するには、ユーザーファイルの例（csv inputs - user and remove lists/users-file.csv）を参照してください。csv ファイルに一覧されているグループは、選択できる名前です。これらは、ディレクトリグループと同じ方法で Adobe ユーザーグループや製品プロファイルにマップされます。 ## diff --git a/docs/jp/success-guide/setup_config_files.md b/docs/jp/success-guide/setup_config_files.md index 1b9934f59..bac7cd082 100644 --- a/docs/jp/success-guide/setup_config_files.md +++ b/docs/jp/success-guide/setup_config_files.md @@ -32,7 +32,7 @@ nav_order: 280 ### ディレクトリアクセスの構成ファイル -ファイルから User Sync を起動する場合は、connector-ldap.yml のセットアップを省略できます。代わりに、「csv inputs - user and remove lists/1 users-file.csv」ファイルの例に従って、ユーザーリストすべてを含む csv ファイルを作成します。このファイルは、リリースの example-configurations.tar.gz ダウンロードに含まれます。 +ファイルから User Sync を起動する場合は、connector-ldap.yml のセットアップを省略できます。代わりに、「csv inputs - user and remove lists/users-file.csv」ファイルの例に従って、ユーザーリストすべてを含む csv ファイルを作成します。このファイルは、リリースの example-configurations.tar.gz ダウンロードに含まれます。 ☐ ファイル connector-ldap.yml を編集します。このファイルにはディレクトリシステムのアクセス情報が含まれます。username、password、host、base_dn の値を入力します。 diff --git a/docs/jp/user-manual/usage_scenarios.md b/docs/jp/user-manual/usage_scenarios.md index 30b651f3c..4c94817bb 100644 --- a/docs/jp/user-manual/usage_scenarios.md +++ b/docs/jp/user-manual/usage_scenarios.md @@ -124,7 +124,7 @@ user-sync --users all --user-filter 'b.*@forxampl.com' --process-groups 取り除く操作を個別に処理する場合、アドビ側には存在するもののエンタープライズディレクトリにはもはや存在しないユーザーをフラグするようツールに指示できます。`--adobe-only-user-action write-file exiting-users.csv` パラメーターは、取り除くようフラグされたユーザーのリストを CSV ファイルに出力します。 -別の呼び出しで取り除く操作を実行するには、`--adobe-only-user-action write-file` パラメーターによって生成されたファイルを渡すか、他の方法で生成したユーザー CSV ファイルを渡すことができます。`csv inputs - user and remove lists` フォルダーにある example-configurations.tar.gz ファイルには、そのようなファイルの例として `3 remove-list.csv` が提供されています。 +別の呼び出しで取り除く操作を実行するには、`--adobe-only-user-action write-file` パラメーターによって生成されたファイルを渡すか、他の方法で生成したユーザー CSV ファイルを渡すことができます。`csv inputs - user and remove lists` フォルダーにある example-configurations.tar.gz ファイルには、そのようなファイルの例として `remove-list.csv` が提供されています。 #### ユーザーを追加して、取り除くユーザーのリストを生成する diff --git a/examples/config files - basic/4 connector-csv.yml b/examples/config files - basic/connector-csv.yml similarity index 100% rename from examples/config files - basic/4 connector-csv.yml rename to examples/config files - basic/connector-csv.yml diff --git a/examples/config files - basic/3 connector-ldap.yml b/examples/config files - basic/connector-ldap.yml similarity index 97% rename from examples/config files - basic/3 connector-ldap.yml rename to examples/config files - basic/connector-ldap.yml index 87cd6c864..1cfae1339 100755 --- a/examples/config files - basic/3 connector-ldap.yml +++ b/examples/config files - basic/connector-ldap.yml @@ -19,8 +19,8 @@ # These access credentials are sensitive and must be protected. username: "LDAP or Credential Manager username goes here" password: "LDAP password goes here" -host: "LDAP host URL goes here. e.g. ldap://ldap.example.com" -base_dn: "defines the base DN. e.g. DC=example,DC=com" +host: "ldap://ldap.example.com" +base_dn: "DC=example,DC=com" # (optional) You can store credentials in the operating system credential store # (Windows Credential Manager, Mac Keychain, Linux Freedesktop Secret Service @@ -43,7 +43,7 @@ base_dn: "defines the base DN. e.g. DC=example,DC=com" # (optional) search_page_size (default value given below) # search_page_size specifies the result page size requested when # fetching values from the directory. -search_page_size: 200 +search_page_size: 1000 # (optional) require_tls_cert (default value given below) # require_tls_cert forces the ldap connection to use TLS security with cerficate @@ -132,9 +132,7 @@ user_email_format: "{mail}" # federation configuration specifies username-based login. In all other cases, # make sure this is not set or returns an empty value, and the user's username # will be taken from the user's email. -# This example supposes that the department and user_id are concatenated to -# produce a unique username for each user. -#user_username_format: "{department}_{user_id}" +#user_username_format: "{sAMAccountName}" # (optional) user_given_name_format (default value given below) # user_given_name_format specifies how to construct a user's given name by diff --git a/examples/config files - basic/5 connector-okta.yml b/examples/config files - basic/connector-okta.yml similarity index 100% rename from examples/config files - basic/5 connector-okta.yml rename to examples/config files - basic/connector-okta.yml diff --git a/examples/config files - basic/2 connector-umapi.yml b/examples/config files - basic/connector-umapi.yml similarity index 98% rename from examples/config files - basic/2 connector-umapi.yml rename to examples/config files - basic/connector-umapi.yml index 043eb50d9..35b8f14f3 100644 --- a/examples/config files - basic/2 connector-umapi.yml +++ b/examples/config files - basic/connector-umapi.yml @@ -38,7 +38,7 @@ enterprise: api_key: "API key goes here" client_secret: "Client secret goes here" tech_acct: "Tech account ID goes here" - priv_key_path: "path/to/private/key/file" + priv_key_path: "private.key" # (optional) As an alternative to priv_key_path, you can place the private key # data directly in this file. To do this, remove the priv_key_path entry above diff --git a/examples/config files - basic/1 user-sync-config.yml b/examples/config files - basic/user-sync-config.yml similarity index 94% rename from examples/config files - basic/1 user-sync-config.yml rename to examples/config files - basic/user-sync-config.yml index 04ac00ff9..5b8428c2f 100644 --- a/examples/config files - basic/1 user-sync-config.yml +++ b/examples/config files - basic/user-sync-config.yml @@ -32,11 +32,11 @@ adobe_users: # (optional) exclude_adobe_groups (no default value) # exclude_adobe_groups is a list of values, each of which is a string - # that names a product configuration or user group on the Adobe side. + # that names a product profile or user group on the Adobe side. # Any user in one or more of the named Adobe groups is excluded from # updates by User Sync. exclude_adobe_groups: - #- "Sample Product Configuration" + #- "Sample Product Profile" #- "Sample User Group" # (optional) exclude_users (no default value) @@ -91,7 +91,7 @@ directory_users: # If your directory does not specify the Adobe-side identity type # for one (or any) of your users, you can specify a default type here that # will be used: one of "adobeID", "enterpriseID", or "federatedID". - user_identity_type: enterpriseID + user_identity_type: federatedID # (optional) default_country_code (no default value) # All Adobe users have a country code, which is a two-letter (ISO-3166) country code @@ -158,7 +158,7 @@ directory_users: # (optional) groups (no default value) # The groups setting specifies how groups in the enterprise directory map - # to product configurations and user groups on the Adobe side (collectively + # to product profile and user groups on the Adobe side (collectively # called "Adobe groups"). This section is required only if you use the # --process-groups command-line argument. groups: @@ -166,22 +166,21 @@ directory_users: # directory groups and whose values are lists of Adobe groups. This mapping # is specified as a list of entries, each of which has a directory_group # setting (whose value is a single directory group) and an adobe_groups - # setting (whose value is a list of 0 or more product configuration and - # user groups). In this example, imagine that "Acrobat DC Pro" is a - # product configuration and "Copy Editors" is a user group, and that - # the "Copy Editors" user group will be assigned access to appropriate - # Adobe products, such as InDesign and InCopy. + # setting (whose value is a list of 0 or more product profile and + # user groups). In this example, users in Adobe_All_Apps_Users directory group will + # automatically be assigned to "Default All Apps plan - 100 GB configuration" (Product Profile) + # and "Creative Users" (User Group) # [You will need to edit or remove these examples.] - - directory_group: "Finance" + - directory_group: "Acrobat_DC_Pro_Users" adobe_groups: - # the finance group doesn't use any Adobe products - - directory_group: "Administration" + - "Acrobat DC Pro Users" + - directory_group: "Adobe_All_Apps_Users" adobe_groups: - - "Acrobat DC Pro" - - directory_group: "Newsletter" + - "Default All Apps plan - 100 GB configuration" + - "Creative Users" + - directory_group: "Adobe_Manual_Assign_Users" adobe_groups: - - "Copy Editors" - - "Acrobat DC Pro" + # Adobe_Manual_Assign_Users group does not have default product profile/user group assignment. # (optional) additional_groups (no default value) # People who use their directory groups for ACLs on the Adobe side @@ -250,7 +249,7 @@ logging: # (optional) log_to_file (default value "False") # Whether you want logging done to a file in addition to the standard output. # allowed values are "True" (log to both) or "False" (log only to standard output). - log_to_file: False + log_to_file: True # (optional) file_log_directory (default value "logs") # An absolute or relative path to the directory where log files should be placed. @@ -324,7 +323,7 @@ invocation_defaults: # For argument --process-groups, the default is False (don't process). # If you set this default to True, you can supply the argument # --no-process-groups to override the default. - process_groups: No + process_groups: Yes # For argument --strategy, the default is 'sync'. strategy: sync # For argument --test-mode (or -t), the default is False (live run). @@ -341,4 +340,4 @@ invocation_defaults: user_filter: # For argument --users, the default is 'all'. # for CSV input, use an array - ['file', 'users.csv'] - users: all + users: mapped diff --git a/examples/config files - custom attributes and mappings/1 extension-config.yml b/examples/config files - custom attributes and mappings/extension-config.yml similarity index 100% rename from examples/config files - custom attributes and mappings/1 extension-config.yml rename to examples/config files - custom attributes and mappings/extension-config.yml diff --git a/examples/csv inputs - user and remove lists/3 remove-list.csv b/examples/csv inputs - user and remove lists/remove-list.csv similarity index 100% rename from examples/csv inputs - user and remove lists/3 remove-list.csv rename to examples/csv inputs - user and remove lists/remove-list.csv diff --git a/examples/csv inputs - user and remove lists/2 users-file-with-custom-attributes-and-mappings.csv b/examples/csv inputs - user and remove lists/users-file-with-custom-attributes-and-mappings.csv similarity index 100% rename from examples/csv inputs - user and remove lists/2 users-file-with-custom-attributes-and-mappings.csv rename to examples/csv inputs - user and remove lists/users-file-with-custom-attributes-and-mappings.csv diff --git a/examples/csv inputs - user and remove lists/1 users-file.csv b/examples/csv inputs - user and remove lists/users-file.csv similarity index 100% rename from examples/csv inputs - user and remove lists/1 users-file.csv rename to examples/csv inputs - user and remove lists/users-file.csv