JarCastingJava library for Hydro Raindrop Api
Introduction
This java library provides a suite of convenience functions intended to simplify the integration of Hydro's Raindrop authentication into your project.
Offical Raindrop API documentation is available here
Dependency
- hydro-oauth2-java 1.0.0
- unirest-java 1.4.9
Compilation
- Java 1.8
- Maven 3
Installation
Recommended
Add below dependency into your pom.xml
<dependency>
<groupId>com.github.serkanalgl</groupId>
<artifactId>hydro-raindrop-java</artifactId>
<version>1.0.0</version>
</dependency>
Manual
You can also install manually:
git clone https://github.com/serkanalgl/hydro-raindrop-java.git
cd hydro-raindrop-java
mvn clean install
Usage
Client-side Raindrop
First, you should initialize RaindropPartnerConfig with Builder and then create a new RaindropClient instance with it.
try{
RaindropPartnerConfig config = new RaindropPartnerConfig.Builder("client id", "client secret", Environment.PRODUCTION)
.setApplicationId("application id")
.build();
RaindropClient client = new Raindrop().client(config);
}catch (Exception e) {
//something went wrong
}
To create a new RaindropPartnerConfig object, you must pass the following parameters:
clientId(required): Your OAuth id for the Hydro APIclientSecret(required): Your OAuth secret for the Hydro APIenvironment(default: SANDBOX):Environment.SANDBOX|Environment.PRODUCTIONapplicationId(required): Your application id for the Hydro API
RaindropClient Functions
registerUser(String hydroId)
To register a user, you will need to collect the HydroID that identifies them on the Hydro app and map it to your application.
try{
BaseResponse response = client.registerUser(hydroId);
}catch (RaindropException e) {
//something went wrong
}
BaseResponseresponse.getStatus(): Returns a 200 if the user has been successfully mapped to your application.response.getMessage(): Success/Error message
generateMessage()
This method generates 6-digit number using with SecureRandom. You should show this number to your users. The user will type into the hydro mobile app.
try{
Integer message = client.generateMessage();
}catch (RaindropException e) {
//something went wrong
}
verifySignature(String hydroId, Integer message)
When the users enter that message into their mobile device, the API will verify that the correct user signed the message against the information stored on the blockchain.
try{
VerifySignature response = client.verifySignature(hydroId, message);
}catch (RaindropException e) {
//something went worng
}
VerifySignatureresponse.isVerified(): Successful verifications will returntrueresponse.getVerificationId(): Returns a UUID for this verification attempt.response.getTimestamp(): The time of this verification attempt.
deleteUser(String hydroId)
For a variety of reasons, a user may want to disable MFA or may delete their account on your platform.
try{
BaseResponse response = client.deleteUser(hydroId);
}catch (RaindropException e) {
//something went wrong
}
BaseResponseresponse.getStatus(): Returns a 200 deleting their mapping to your application.response.getMessage(): Success/Error message
Server-side Raindrop
First, you should initialize RaindropPartnerConfig with Builder and then create a new RaindropServer instance with it.
try{
RaindropPartnerConfig config = new RaindropPartnerConfig.Builder("client id", "client secret", Environment.PRODUCTION).build();
RaindropServer server = new Raindrop().server(config);
}catch (Exception e) {
//something went wrong
}
To create a new RaindropPartnerConfig object, you must pass the following parameters:
clientId(required): Your OAuth id for the Hydro APIclientSecret(required): Your OAuth secret for the Hydro APIenvironment(default: SANDBOX):Environment.SANDBOX|Environment.PRODUCTION
RaindropServer Functions
whitelist(String address)
Add address to whitelist ( be careful, for security purposes, the id will only be generated one time. ) The hydroAddressId should be stored on your databasse.
try{
String address = "0x..."; //The user’s Ethereum/Hydro address
Whitelist whitelist = server.whitelist(address);
}catch (RaindropException e) {
//something went wrong
}
Whitelistwhitelist.getStatus(): Returns a 200 if the address has been whitelisted.whitelist.getMessage(): Success/Error messagewhitelist.getHydroAddressId(): The authenticating user’s newly assigned address idwhitelist.getTransactionHash(): The hash of the transaction whitelisting the user
challenge(String hydroAddressId)
After being whitelisted, each user must authenticate through the Server-side Raindrop process once every 24 hours to retain access to the protected system.
try{
Challenge challenge = server.challenge(hydroAddressId);
}catch (RaindropException e) {
//something went wrong
}
Challengechallenge.getStatus(): Returns a 200 if challenge response is success.challenge.getMessage(): Success/Error messagechallenge.getAmount(): The challenge amountchallenge.getChallenge(): The challenge stringchallenge.getPartnerId(): The unique identifier assigned to your firmchallenge.getTransactionHash(): The hash of the transaction that updates the user’s raindrop requirements
You will need to relay these values to the authenticating user who will send them to a Hydro smart contract, so treat them accordingly.
authenticate(String hydroAddressId)
Once the raindrop has been completed by the end user and confirmed in the blockchain, the final authentication check can be performed.
try{
Authenticate authenticate = server.authenticate(hydroAddressId);
}catch (RaindropException e) {
//something went wrong
}
Authenticateauthenticate.isAuthenticated(): Returnstrueif authenticatedauthenticate.getAuthenticationId(): A UUID for this verification attempt.authenticate.getTimestamp(): The time of this verification attempt.
Generic Functions for Client and Server
transactionStatus(String transactionHash)
Certain methods in the Hydro API trigger transactions on the Ethereum blockchain. Transactions take time to be confirmed, so rather than waiting for confirmation, these methods will return a transaction_hash as soon as our internal logic has completed successfully and the appropriate transaction has been broadcast to the Ethereum network.
Example code for Raindrop Client:
try{
RaindropPartnerConfig config = new RaindropPartnerConfig.Builder("client id", "client secret", Environment.PRODUCTION)
.setApplicationId("application id")
.build();
RaindropClient client = new Raindrop().client(config);
TransactionStatus transactionStatus = client.transactionStatus("0x....");
}catch (RaindropException e) {
//something went wrong
}
Example code for Raindrop Server:
try{
RaindropPartnerConfig config = new RaindropPartnerConfig.Builder("client id", "client secret", Environment.PRODUCTION).build();
RaindropServer server = new Raindrop().server(config);
TransactionStatus transactionStatus = server.transactionStatus("0x....");
}catch (RaindropException e) {
//something went wrong
}
TransactionStatustransactionStatus.isCompleted(): Indication of whether the transaction has been confirmedtransactionStatus.getTransactionHash(): The transaction hash
Contact
If you have any further question/suggestion/issue, do not hesitate to contact me.
Donate
Ethereum
Copyright
Copyright (c) 2018, Under MIT licence Serkan Algül. All rights reserved.