Este guia irá auxiliar a acessar a API pública através do cliente OAuth.
Tendo em mão as consumer keys, é necessário cadastrá-las no fluig como um OAuth App, utilizando o provider padrão, as chaves criptografadas são informadas no cadastro, as descriptografadas são utilizadas no cliente.
Para utilizar o cliente é necessário incluir a dependência:
<dependency> <groupId>com.fluig</groupId> <artifactId>oauth-client</artifactId> <version>1.0</version> </dependency> |
Cria e configura o client para o domínio desejado.
// Cria o client e atribui domínio e consumer keys OAuthClient oAuthClient = new OAuthClient(domainProvider, FLUIG_CONSUMER_KEY, FLUIG_CONSUMER_SECRET); |
Realiza o processo de autenticação, é necessário informar o usuário e senha para autorizar o acesso.
// O retorno da negociação e autenticação do usuário. LoginResult result = oAuthClient.prepareResources(user, password); HttpHelper.closeResource(result.getConnection()); // Checa o código de retorno if (HttpHelper.returnSuccess(result.getConnection())) { System.out.println("Sucesso!"); } |
É possível recuperar os tokens de acesso, após a autenticação.
oAuthClient.getToken(); oAuthClient.getTokenSecret(); |
Após autenticado o cliente permite assinar outras conexões do tipo HttpURLConnection, isso permite fazer realizar chamadas REST.
URL url = new URL("http://..."); HttpURLConnection connection = (HttpURLConnection) urlProvisioningTenant.openConnection(); //configurações da requisição .... // Assina a conexão oAuthClient.sign(connection); |
O projeto de exemplo esta disponível no projeto SAMPLES:
http://git.fluig.com/projects/SAMPLES/repos/oauth-client-sample