seacat-android-g3

SeaCat SDK is the 3rd generation of a SeaCat client for Android.

License

License

GroupId

GroupId

com.teskalabs.seacat
ArtifactId

ArtifactId

seacat-android-g3
Last Version

Last Version

21.04.01
Release Date

Release Date

Type

Type

aar
Description

Description

seacat-android-g3
SeaCat SDK is the 3rd generation of a SeaCat client for Android.
Project URL

Project URL

https://github.com/TeskaLabs/SeaCat-Android-G3
Source Code Management

Source Code Management

https://github.com/TeskaLabs/SeaCat-Android-G3/tree/master

Download seacat-android-g3

How to add to project

<!-- https://jarcasting.com/artifacts/com.teskalabs.seacat/seacat-android-g3/ -->
<dependency>
    <groupId>com.teskalabs.seacat</groupId>
    <artifactId>seacat-android-g3</artifactId>
    <version>21.04.01</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/com.teskalabs.seacat/seacat-android-g3/
implementation 'com.teskalabs.seacat:seacat-android-g3:21.04.01'
// https://jarcasting.com/artifacts/com.teskalabs.seacat/seacat-android-g3/
implementation ("com.teskalabs.seacat:seacat-android-g3:21.04.01")
'com.teskalabs.seacat:seacat-android-g3:aar:21.04.01'
<dependency org="com.teskalabs.seacat" name="seacat-android-g3" rev="21.04.01">
  <artifact name="seacat-android-g3" type="aar" />
</dependency>
@Grapes(
@Grab(group='com.teskalabs.seacat', module='seacat-android-g3', version='21.04.01')
)
libraryDependencies += "com.teskalabs.seacat" % "seacat-android-g3" % "21.04.01"
[com.teskalabs.seacat/seacat-android-g3 "21.04.01"]

Dependencies

compile (2)

Group / Artifact Type Version
org.jetbrains.kotlin : kotlin-android-extensions-runtime jar 1.3.61
org.jetbrains.kotlin : kotlin-stdlib-jdk7 jar 1.3.61

Project Modules

There are no modules declared in this project.

SeaCat SDK for Android

The 3rd generation of a SeaCat client for Android.

Installation from GitHub

The installation procedure has been inspired by this blog article. We assume that your Android project is managed by Git version control system.

  1. From Android Studio project terminal add git sub-module

     git submodule add https://github.com/TeskaLabs/SeaCat-Android-G3.git
    

    Android Studio: adding a git submodule

  2. Open Android Studio > File menu > Project Structure...

  3. Go to "Modules" and hit "+" (aka New Module)

    Android Studio: adding a submodule

  4. Select "Import Gradle Project"

  5. Select "Source directory", it is "SeaCat-Android-G3" folder in your project.

  6. Unselect "demo" checkbox.

    Android Studio: module import

  7. Press "Finish".

  8. Wait for Gradle to finish.

  9. Stay in "Project Structure" dialog, go to "Dependencies". select your application and "+" (aka Add Dependency)

    Android Studio: add dependency

  10. Select "Module Dependency"

  11. Select "seacat" and press "OK"

Android Studio: add dependency

  1. Press "OK" to close "Project Structure" dialog.
  2. The SeaCat client has been added to your project, please continue to a "Quick start" chapter.

Quick start

  1. SeaCat client needs to be initialized in your application class.

    Kotlin:

    ...
    import com.teskalabs.seacat.SeaCat
    ...
    
    class MyApplication : Application() {
    
    	...
    	lateinit var seacat: SeaCat
    	...
    
    	override fun onCreate() {
    		...
    		seacat = SeaCat(this, "https://pki.seacat.io/seacat-demo/seacat")
    		...
    	}
    }
    

    Remark: https://pki.seacat.io/seacat-demo/seacat is a public demo instance of the SeaCat PKI.

  2. Test

    Make URL request to SeaCat gateway at https://seacat-demo.seacat.io/hello

    • 200 means that all is good and the client is authenticated by SeaCat
    • 403 means that the authentication failed (the client is untrusted by a gateway)
com.teskalabs.seacat

TeskaLabs

TeskaLabs is a software vendor focused on cyber-security. We love open-source.

Versions

Version
21.04.01
21.4.0