# Fornecendo acesso

## **Single Sign-On (SSO)**

Esta é a melhor opção para conceder acesso fácil a contas acadêmicas, governamentais ou corporativas. Os usuários podem acessar de qualquer lugar, sem precisar de credenciais individuais, mantendo todas as funcionalidades de uma conta pessoal e segura. Quando alguém usa este método para entrar no vLex, o serviço cria automaticamente uma nova conta corporativa pessoal quando eles fazem login.

Para usuários administradores, o SSO fornece estatísticas úteis, como o número de usuários que acessam o vLex e a frequência de suas sessões individuais.

### Protocolo SSO do vLex

O protocolo SSO do vLex é a maneira mais simples de fornecer uma experiência SSO. Sua equipe de TI instalará uma página de código em uma área privada do seu site, e os usuários que acessarem essa página serão redirecionados ao vLex, onde serão autenticados automaticamente.

Para iniciar o processo de implementação do SSO para sua conta, entre em contato com <support@vlex.com> e iniciaremos o processo de ativação fornecendo a você o **Token de autenticação** e das **ID da conta**.

{% hint style="danger" %}
O **Token de autenticação** é privado. Não forneça acesso a essa informação a terceiros.
{% endhint %}

Quando tiver essas informações, crie uma página em seu servidor privado que possa verificar um usuário antes de redirecioná-lo para o link autenticado.

{% hint style="success" %}
O código para isso está disponível publicamente em [Autenticação remota↗](https://github.com/vlex/remote_auth). Você pode encontrá-lo nas seguintes linguagens de programação:&#x20;

* PHP&#x20;
* Ruby&#x20;
* ASP Classic&#x20;
* ColdFusion&#x20;
* JSP&#x20;
* Python&#x20;
* C#
  {% endhint %}

#### Programando o código

Se desejar programar a página do zero, o link URL deve ser:  `http://vlex.com/session/remote_auth`&#x20;

Esse link deve ter os seguintes parâmetros GET:

* **name**: o nome do usuário (John Smith)
* **email**: o e-mail do usuário (<johnsmith@email.com>)
* **timestamp**: o momento em que o link é gerado, representado em segundos desde a Epoch (1049896564)
* **account\_id**: o ID da sua conta, esses dados aparecem ao ativar a integração da conta.
* **hash**: o valor usado para validar os demais campos, é calculado como: hexdigest(MD5(name+email+account\_id+token+timestamp))

O **hash** deve ser **criptografado** com os parâmetros indicados acima, que nunca serão os mesmos pois incluem o **timestamp**. O símbolo + representa uma concatenação de conjuntos de strings. Ao calcular o **hash**, a ordem dos campos é relevante.

## **Acesso por IP**

{% hint style="warning" %}
Embora o vLex suporte Acesso por IP (incluindo acesso por proxy), nossa recomendação é implementar acesso via SSO.
{% endhint %}

Quando seus usuários estiverem conectados à rede da sua organização, eles poderão acessar o vLex sem entrar em suas contas pessoais, embora percam alguma funcionalidade.&#x20;

Se você quiser oferecer essa opção à sua organização, entre em contato com o atendimento ao cliente pelo <support@vlex.com> e informe a lista ou o intervalo de IPs que deseja incluir.

{% hint style="warning" %}
Se você tiver problemas para determinar os IPs para conceder acesso à sua organização, a equipe de contas do vLex pode fornecer assistência. [Contate-nos](https://support.vlex.com/pt-br-vlex-library-knowledge-base/support-1/contact-us).
{% endhint %}

{% hint style="info" %}
Usuários que acessam o vLex por esse método não poderão usar recursos que dependem de e-mails, como [alertas](https://support.vlex.com/pt-br-vlex-library-knowledge-base/getting-started/configurando/alerts#alerts) e [histórico](https://support.vlex.com/pt-br-vlex-library-knowledge-base/getting-started/quick-start-guide/history). Eles podem contornar o IP criando uma conta pessoal e fazendo login com um ID de usuário e senha.&#x20;
{% endhint %}

## **Proxy HTTP**

Você pode fornecer aos seus usuários a mesma funcionalidade que obtêm com o Acesso por IP quando não estão conectados à sua rede. Para isso, é preciso habilitar um proxy HTTP. As implementações de proxy suportadas são **EZProxy** e **Proxy WAM.**&#x20;

Para isso, entre em contato com o atendimento ao cliente em <support_academic@vlex.com> e informe a lista ou intervalo de IPs dos proxies que você gostaria de ativar.

{% hint style="warning" %}
Se você tiver problemas para determinar os IPs para conceder acesso à sua organização, a equipe de contas do vLex pode fornecer assistência. [Contate-nos](https://support.vlex.com/pt-br-vlex-library-knowledge-base/support-1/contact-us).
{% endhint %}

Assim que concluirmos a implementação, forneceremos o endereço URL que você deverá usar para acessar o serviço.