Skip to content

Snapshot Version 1.1.1 Update #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Mar 10, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.md → .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
## Contributing:
## Contributing
We welcome your involvement, be it fixing bugs or implementing new features that you find relevant to this library.

To contribute, you may follow the steps below:
Expand Down
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,10 @@ Please delete options that are not relevant.
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] This change requires a documentation update
- [ ] Code enhancement and update (non-breaking change)
- [ ] Security patch

# How Has This Been Tested?
## How Has This Been Tested?

Please describe or list the test cases that you ran to verify your changes, and provide instructions so we can reproduce.

6 changes: 5 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,8 @@
+ Update interface name so as be intuitive
+ Update corresponding test cases
+ Include Issue/PR templates
+ Include Contribution template
+ Include Contribution template
### V1.1.1-SNAPSHOT
+ Minor refactoring
+ Update documentation
+ Update templates
48 changes: 35 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,17 +5,36 @@

A java helper utilities that form HTTP security header for authentication and verification

## Table of Contents
- [Getting Started](#getting-started)
* [Using Maven](#maven-guide)
+ [Maven Build Option](#maven-build-option)
* [Using Gradle](#gradle-guide)
+ [Preparation](#preparation)
+ [Gradle Build Option](#gradle-build-option)
+ [Gradle Test](#gradle-test)
* [Development](#development)
+ [Constructing Signature BaseString](#constructing-signature-basestring)
+ [Constructing HMAC256 L1 Header](#constructing-hmac256-l1-header)
+ [Constructing RSA256 L2 Header](#constructing-rsa256-l2-header)
+ [Preparing HTTP Signature Token](#preparing-http-signature-token)
- [Release](#release)
- [Contributing](#contributing)
- [License](#license)
- [References](#references)

## Getting Started
Include this helper class in your java project to perform API Security operations

This project use Maven or Gradle as its build and management tools


### Maven Guide

+ Download and Install Maven (3.5.0 or above)
+ Java (1.8)

#### Build
#### Maven Build Option

**Option 1:** Compile and package into JAR

Expand Down Expand Up @@ -76,14 +95,14 @@ As some of the test cases contains UTF-8 characters, you have to set following p
export GRADLE_OPTS="-Dfile.encoding=utf-8"
```

#### Build
#### Gradle Build Option
**Option 1:** Compile and package into JAR

```bash
gradle clean build
```

#### Test
#### Gradle Test
To test with Jacoco and publish a html report

```bash
Expand Down Expand Up @@ -111,9 +130,9 @@ dependencies {

```

#### Development
### Development

##### Preparing Signature BaseString :
#### Constructing Signature BaseString

Method:
* getBaseString
Expand Down Expand Up @@ -156,7 +175,7 @@ System.out.println(baseString);

```

##### Preparing HMACSHA256 L1 Security Signature :
#### Constructing HMAC256 L1 Header

Method:
* getHMACSignature
Expand All @@ -180,7 +199,7 @@ try {

```

##### Preparing RSA256 L2 Security Signature :
#### Constructing RSA256 L2 Header

Method:
* getRSASignature
Expand Down Expand Up @@ -213,7 +232,7 @@ try {

```

##### Preparing HTTP Signature Token :
#### Preparing HTTP Signature Token

Append this signature token into the Authorization header of the HTTP request

Expand Down Expand Up @@ -250,13 +269,16 @@ try {
}
```

### Contributing
+ For more information about contributing PRs and issues, see [CONTRIBUTING.md](CONTRIBUTING.md).
## Contributing
For more information about contributing PRs and issues, see [CONTRIBUTING.md](.github/CONTRIBUTING.md).

## Release
See [CHANGELOG.md](CHANGELOG.md).

### Release
+ See [CHANGELOG.md](CHANGELOG.md).
## License
[MIT LICENSE](LICENSE).

### Reference:
## References
+ [UTF-8 in Gradle](https://stackoverflow.com/questions/21267234/show-utf-8-text-properly-in-gradle)
+ [SLF4J FAQ](https://www.slf4j.org/faq.html)
+ [Akana API Consumer Security](http://docs.akana.com/ag/cm_policies/using_api_consumer_app_sec_policy.htm)
Expand Down
2 changes: 1 addition & 1 deletion build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ plugins {
id 'com.github.kt3k.coveralls' version '2.6.3'
}

version '1.1.0-SNAPSHOT'
version '1.1.1-SNAPSHOT'

tasks.withType(JavaCompile) {
options.encoding = "UTF-8"
Expand Down
2 changes: 1 addition & 1 deletion pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<modelVersion>4.0.0</modelVersion>
<groupId>com.api.util</groupId>
<artifactId>ApiSecurity</artifactId>
<version>1.1.0-SNAPSHOT</version>
<version>1.1.1-SNAPSHOT</version>
<build>
<plugins>
<plugin>
Expand Down