Skip to content

Commit 59cc6a5

Browse files
authored
Merge pull request #302 from adobe-apiplatform/v2
prepare for v2.2.2rc3 release
2 parents 205b53f + 3cceceb commit 59cc6a5

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

54 files changed

+9174
-7
lines changed

Makefile

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ pex:
2323
-f $(prebuilt_dir) \
2424
--disable-cache \
2525
--not-zip-safe .
26-
-$(RM) wheelhouse
2726

2827
test:
2928
nosetests --no-byte-compile tests

RELEASE_NOTES.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Release Notes for User Sync Tool Version 2.2.2
22

3-
These notes apply to v2.2.2rc2 of 2017-10-29.
3+
These notes apply to v2.2.2rc3 of 2017-11-14.
44

55
## New Features
66

@@ -16,6 +16,8 @@ These notes apply to v2.2.2rc2 of 2017-10-29.
1616

1717
[#293](https://github.com/adobe-apiplatform/user-sync.py/issues/293): Don't crash when existing users are added to secondaries.
1818

19+
[#301](https://github.com/adobe-apiplatform/user-sync.py/issues/301): User Sync fails when adding more than 10 groups to a user.
20+
1921
## Compatibility with Prior Versions
2022

2123
There are no interface changes from prior versions.

docs/_includes/post-nav-area.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,5 @@
66
<li><a href="{{page.url | relative_url | replace: lang, '/es/'}}">Español</a></li>
77
<li><a href="{{page.url | relative_url | replace: lang, '/fr/'}}">Français</a></li>
88
<li><a href="{{page.url | relative_url | replace: lang, '/jp/'}}">日本語</a></li>
9+
<li><a href="{{page.url | relative_url | replace: lang, '/bp/'}}">Português</a></li>
910
</ul>

docs/_layouts/default.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
<ul>
1515

1616
{% assign current_level = 1 %}
17-
{% assign page_list = (site.pages) %}
17+
{% assign page_list = site.pages %}
1818
{% assign filtered_list = page_list | where_exp: 'page', "page.nav_level > 0" %}
1919
{% for my_page in filtered_list %}
2020
{% comment %}---{{my_page.lang}} --- {{my_page.url}} --- {{my_page.nav_order}}<br/>{% endcomment %}

docs/art/bp/user-guide/adobe-to-enterprise-connections.ai

Lines changed: 4997 additions & 0 deletions
Large diffs are not rendered by default.

docs/art/bp/user-guide/group-mapping.ai

Lines changed: 901 additions & 0 deletions
Large diffs are not rendered by default.

docs/bp/FAQ/index.md

Lines changed: 156 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,156 @@
1+
---
2+
layout: page
3+
title: Perguntas frequentes sobre o User Sync
4+
advertise: FAQ
5+
lang: bp
6+
nav_link: FAQ
7+
nav_level: 1
8+
nav_order: 500
9+
---
10+
### Sumário
11+
{:.“no_toc”}
12+
13+
* Marcador TOC
14+
{:toc}
15+
16+
17+
### O que é o User Sync?
18+
19+
Uma ferramenta que permite que empresas criem/gerenciem usuários
20+
e atribuições de direito da Adobe utilizando o Active Directory (ou outros
21+
serviços de diretório OpenLDAP testados). Os usuários-alvo são administradores de identidade de TI
22+
(administradores de diretórios corporativos/de sistemas) que poderão
23+
instalar e configurar a ferramenta. A ferramenta-de código aberto é personalizável
24+
para que um desenvolvedor possa modificá-la para atender às
25+
necessidades particulares dos clientes.
26+
27+
### Por que o User Sync é importante?
28+
29+
O User Sync, uma ferramenta-independente de nuvem (CC, EC, DC), serve como um catalisador
30+
para mover mais usuários para a implantação de usuários nomeados e aproveitar totalmente
31+
os recursos de produtos e serviços no Admin Console.
32+
33+
### Como funciona?
34+
35+
Quando o User Sync é executado, ele obtém uma lista de usuários do Active Directory
36+
da organização (ou de outra fonte de dados) e a compara com a lista de
37+
usuários no Admin Console. Em seguida, ele chama a API de gerenciamento de usuários da Adobe
38+
para que o Admin Console seja sincronizado com o diretório da
39+
organização. O fluxo de mudanças é totalmente-unidirecional; as edições feitas no
40+
no Admin Console não são enviadas para o diretório.
41+
42+
As ferramentas permitem que o administrador do sistema mapeie grupos de usuários no diretório do cliente
43+
com configuração de produto e grupos de usuários no Admin Console
44+
45+
Para configurar o User Sync, a organização precisa criar um conjunto de credenciais
46+
da mesma forma que faria para usar a API de gerenciamento de usuários.
47+
48+
### Onde posso obtê-lo?
49+
50+
O User Sync é de código aberto, distribuído sob a licença MIT e mantido pela Adobe. Ele está disponível [aqui](https://github.com/adobe-apiplatform/user-sync.py/releases/latest).
51+
52+
53+
### O User Sync se aplica a-servidores locais e do Azure Active Directory?
54+
55+
O User Sync é compatível com servidores locais ou do AD (Active Directory) hospedados pelo Azure, bem como qualquer outro servidor LDAP. Ele também pode ser executado a partir de um arquivo local.
56+
57+
### O AD é tratado como um servidor LDAP?
58+
59+
Sim, o AD é acessado por meio do protocolo LDAP v3, que é totalmente compatível com o AD.
60+
61+
### O User Sync coloca automaticamente todos os meus grupos de usuários do LDAP/AD no Adobe Admin Console?
62+
63+
Não. Nos casos
64+
em que os grupos do lado da empresa correspondam às configurações desejadas de acesso
65+
ao produto, o arquivo de configuração do User Sync pode ser configurado para mapear
66+
usuários para configurações de produtos (PCs) ou grupos de usuários no lado
67+
da Adobe com base na associação-da empresa. Grupos de usuários e configurações de produtos devem ser configurados manualmente no Adobe Admin Console.
68+
69+
70+
### O User Sync pode ser usado para gerenciar a associação em grupos de usuários ou apenas em configurações de produtos?
71+
72+
No User Sync, você pode usar grupos de usuários ou configurações de produtos no mapeamento de grupos de diretórios. Dessa forma, os usuários podem ser adicionados ou removidos de grupos de usuários, bem como de PCs. No entanto, não é possível criar novos grupos de usuários ou configurações de produtos; isso deve ser feito no Admin Console.
73+
74+
### Nos exemplos no manual do usuário, vejo que cada grupo de diretórios é mapeado exatamente para um grupo da Adobe; é possível mapear 1 grupo do AD para várias configurações de produtos?
75+
76+
A maioria dos exemplos mostra apenas um único grupo de usuários ou PC da Adobe, mas o mapeamento pode ser feito de um para vários. Basta listar todos os grupos de usuários ou PCs, um por linha, com um hífen “-” na frente (e recuado para o nível adequado) de cada um, conforme o formato da lista YML.
77+
78+
### A limitação do servidor UMAPI pode interferir na operação do User Sync?
79+
80+
Não, o User Sync processa a limitação e as novas tentativas, de modo que
81+
essa limitação poderá causar lentidão no processo geral do User Sync, mas nenhum problema é causado pela limitação,
82+
e o User Sync concluirá todas as operações corretamente.
83+
84+
Os sistemas Adobe se protegem contra sobrecarga ao monitorar o volume
85+
de solicitações recebidas. Se o volume exceder os limites, as solicitações retornarão
86+
um cabeçalho "retry-after", que indicará quando a capacidade estará disponível novamente. O User Sync considera esses cabeçalhos e aguarda o tempo solicitado antes de tentar novamente. Você pode obter mais informações, incluindo exemplos de código, na [documentação da API de gerenciamento de usuários](https://www.adobe.io/apis/cloudplatform/usermanagement/docs/gettingstarted.html).
87+
88+
### Existe uma lista local de usuários criados/atualizados (no lado do User Sync) para reduzir as chamadas do servidor da Adobe?
89+
90+
Quando é executado, o User Sync sempre consulta os sistemas de gerenciamento de usuários da Adobe para obter
91+
informações atualizadas, exceto no caso a seguir. Existe uma opção disponível na
92+
versão 2.2 ou posterior do User Sync para impedir essa consulta e enviar atualizações para a Adobe sem
93+
considerar o estado atual dos usuários no sistema de gerenciamento de usuários da Adobe. Se você puder determinar
94+
quais usuários mudaram no diretório local e tiver certeza de que outros usuários
95+
não foram alterados no sistema da Adobe, essa abordagem poderá reduzir o tempo de execução
96+
(e uso da rede) de seus trabalhos de sincronização.
97+
98+
### A ferramenta User Sync é limitada a federated IDs ou qualquer tipo de ID pode ser criada?
99+
100+
O User Sync é compatível com todos os tipos de ID (Adobe IDs, Federated IDs e Enterprise IDs).
101+
102+
### Uma organização Adobe pode ter acesso a usuários de domínios pertencentes a outras organizações. O User Sync consegue lidar com esse caso?
103+
104+
Sim. O User Sync pode tanto consultar quanto gerenciar
105+
a associação a grupos de usuários e o acesso a produtos para usuários em domínios próprios e acessados. Entretanto,
106+
assim como o Admin Console, o User Sync só pode ser usado para criar e atualizar
107+
contas de usuários em domínios próprios e não em domínios pertencentes a outras organizações. Os usuários desses
108+
domínios podem receber acesso a produtos, mas não podem ser editados ou excluídos.
109+
110+
### Existe uma função de atualização ou só é possível adicionar/remover usuários (somente para Federated ID)?
111+
112+
Para todos os tipos de ID (Adobe, Enterprise e Federated), o User Sync suporta
113+
a atualização de associações a grupos sob o controle da opção --process-groups.
114+
Para Enterprise e Federated IDs, o User Sync suporta a atualização de campos de nome,
115+
sobrenome e email sob o controle da opção --update-user-info. Quando houver
116+
atualizações de país disponíveis no Admin Console, elas também estarão
117+
disponíveis por meio da UMAPI. E para Federated IDs cuja “Configuração de logon de usuário”
118+
for “Nome de usuário”, o User Sync oferecerá suporte a atualização de nome de usuário e de outros campos.
119+
120+
### A ferramenta User Sync é dedicada a um sistema operacional específico?
121+
122+
O User Sync é um projeto Python de código aberto. Os usuários podem compilá-lo para qualquer plataforma de sistema operacional que desejarem. Oferecemos compilações para as plataformas Windows, OS X, Ubuntu e Cent OS 7.
123+
124+
### Ele foi testado no Python 3.5?
125+
126+
O User Sync foi executado com sucesso no Python 3.x, mas na maioria das vezes, foi utilizado e testado no Python 2.7, portanto, você poderá se deparar com algum problema, e fornecemos compilações apenas no Python 2.7. Você pode comunicar qualquer problema (e colaborar com correções) no site de código aberto em https://github.com/adobe-apiplatform/user-sync.py.
127+
128+
### Se algo mudar na API (por exemplo, um novo campo na criação de usuários), como a atualização será aplicada à ferramenta User Sync?
129+
130+
O User Sync é um projeto de código aberto. Os usuários podem baixar e compilar as fontes mais recentes
131+
a seu critério. A Adobe publicará novas versões com compilações periodicamente.
132+
Os usuários podem ser informados sobre elas por meio de notificações do git. Ao adotar uma nova versão,
133+
apenas o arquivo pex único precisa ser atualizado pelo usuário. Se houver alterações de configuração
134+
ou alterações de linhas de comando para suportar novos recursos, poderá haver atualizações nesses
135+
arquivos para que possam ser utilizadas.
136+
137+
Observe também que o User Sync é compilado sobre umapi-client, que é o único módulo com conhecimento direto da API. Quando há alterações da API, o umapi-client sempre é atualizado para manter a compatibilidade com ela. Se e quando as alterações da API fornecerem mais recursos relacionados ao User Sync,-o User Sync poderá ser atualizado para fornecê-los.
138+
139+
### O User Sync precisa de algum tipo de whitelist com as regras de firewall da máquina em que ele é executado?
140+
141+
Em geral, não. O User Sync é apenas um cliente de rede e não aceita conexões de entrada, portanto, as regras de firewall local da máquina-para conexões de entrada são irrelevantes.
142+
143+
No entanto, como cliente de rede, o User Sync requer acesso de saída SSL (porta 443) por meio de firewalls de rede do cliente para acessar os servidores da Adobe. Se configuradas dessa forma, as redes de clientes também precisam permitir que o User Sync acesse o servidor do LDAP/AD do cliente, na porta especificada na configuração do User Sync (porta 389, por padrão).
144+
145+
### O User Sync faz parte da oferta da Adobe para clientes EVIP?
146+
147+
Sim, todos os clientes corporativos têm acesso à UMAPI e ao User Sync, independentemente do programa de compra (E-VIP, ETLA ou Enterprise Agreement).
148+
149+
### Qual é a situação de internacionalização da ferramenta User Sync; ela está habilitada para internacionalização (compatível, pelo menos, com a entrada de caracteres-de byte duplo)?
150+
151+
As versões anteriores do User Sync ofereciam suporte errático a dados de caracteres
152+
internacionais, embora funcionassem de forma bastante confiável com-fontes de dados codificadas
153+
em utf8. A partir da versão 2.2, o User Sync foi totalmente habilitado para-Unicode e pode aceitar
154+
arquivos de configuração e fontes de dados de diretórios ou planilhas que usem qualquer
155+
codificação de caracteres (com uma expectativa padrão de utf8).
156+

docs/bp/index.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
layout: page
3+
title: Sobre o User Sync
4+
nav_link: Sobre o User Sync
5+
nav_level: 1
6+
nav_order: 1
7+
lang: bp
8+
---
9+
10+
Bem-vindo ao centro de documentações do [User Sync da Adobe](https://github.com/adobe-apiplatform/user-sync.py).
11+
12+
# O que é o User Sync?
13+
14+
O User Sync é uma ferramenta-de linha de comando que transfere as informações de usuários e grupos
15+
do sistema de diretórios corporativo da sua organização
16+
(como um Active Directory ou outro sistema LDAP) para o
17+
diretório da sua organização no Adobe Admin Console.
18+
19+
Cada vez que você executa o User Sync, ele procura diferenças entre as
20+
informações de usuários e de grupos nos dois sistemas e atualiza o
21+
diretório Adobe para corresponder às informações em seu diretório.
22+
23+
# Guia de instalação e sucesso
24+
25+
A maneira mais rápida de começar a usar o User Sync é ler o
26+
[Guia de instalação e sucesso](success-guide/index.md), que fornece instruções
27+
passo-a-passo para definir os arquivos de configuração necessários
28+
e executar a ferramenta.
29+
30+
# Manual do usuário
31+
32+
Para saber todos os detalhes sobre como utilizar o User Sync, incluindo como configurá-lo
33+
para vários cenários diferentes de uso típico, leia atentamente
34+
o [Manual do usuário](user-manual/index.md). Ele também é o seu ponto de partida
35+
para personalizar o comportamento do User Sync, pois inclui
36+
instruções para fazer mapeamentos personalizados entre as informações do diretório do cliente
37+
e os dados do lado da Adobe.
38+
39+
# Perguntas frequentes
40+
41+
Compilamos um [documento de perguntas frequentes](FAQ/index.md) que responde a muitas perguntas que nos foram feitas e a outras possíveis dúvidas.
42+

0 commit comments

Comments
 (0)