Added support for ngrok authToken (#61)

* Added support for ngrok authToken

* added auth token to test app

* test fixes

* CI tests

* Fixes automation tests

* CI fix

* CI fix vNEXT

* CI fix vNEXT

* CI fix vNEXT

* CI fix vNEXT

* CI fix vNEXT

* CI fix vNEXT

* CI fix vNEXT

* dependencies versions bump

* added docs about authToken

Author: kilmajster

.github/scripts/set-current-starter-version-macos.sh

@@ -15,7 +15,7 @@
 	<description>Dummy app for tests</description>
 	<properties>
 		<java.version>11</java.version>
-		<ngrok-spring-boot-starter.version>ci-version-placeholder</ngrok-spring-boot-starter.version>
+		<ngrok-spring-boot-starter.version>SNAPSHOT</ngrok-spring-boot-starter.version>
 	</properties>
 	<dependencies>
 		<dependency>

.github/scripts/set-current-starter-version.sh

@@ -20,17 +20,12 @@
 
 import static org.assertj.core.api.Assertions.assertThat;
 
-@SpringBootTest(
-        webEnvironment = SpringBootTest.WebEnvironment.DEFINED_PORT,
-        properties = {
-                "ngrok.enabled=true"
-        }
-)
+@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.DEFINED_PORT)
 @ExtendWith(OutputCaptureExtension.class)
 class AppTests {
 
     private final static Logger log = LoggerFactory.getLogger(AppTests.class);
-    private static final int WAIT_FOR_STARTUP_SECONDS = 30;
+    private static final int WAIT_FOR_STARTUP_SECONDS = 90;
     private static final String HTTPS_NGROK_TUNNEL_REGEX = "(https:\\/\\/)?(([^.]+)\\.)?ngrok\\.io";
 
     @Test

.github/test-app/pom.xml

@@ -0,0 +1,2 @@
+ngrok.enabled=true
+

.github/test-app/src/test/java/io/github/kilmajster/AppTests.java

@@ -19,12 +19,10 @@ jobs:
       - name: Silent install main project
         run: mvn --batch-mode --no-transfer-progress install -Dmaven.test.skip=true
 
-      - name: Install xmllint
-        run: brew install xmlstarlet
-
-      - name: Set current starter version in test-app
-        working-directory: ./.github/scripts/
-        run: sh set-current-starter-version-macos.sh
+      - name: Add ngrok auth token application.properties
+        run: |
+          printf ${{secrets.NGROK_AUTH_TOKEN_PROPERTY}} >> .github/test-app/src/test/resources/application.properties
+        shell: bash
 
       - name: Run automation tests with latest ngrok-spring-boot-starter version on test-app
         working-directory: ./.github/test-app/

.github/test-app/src/test/resources/application.properties

@@ -19,12 +19,10 @@ jobs:
       - name: Silent install main project
         run: mvn --batch-mode --no-transfer-progress install -Dmaven.test.skip=true
 
-      - name: Install xmllint
-        run: sudo apt-get install libxml2-utils
-
-      - name: Set current starter version in test-app
-        working-directory: ./.github/scripts/
-        run: sh set-current-starter-version.sh
+      - name: Add ngrok auth token application.properties
+        run: |
+          printf ${{secrets.NGROK_AUTH_TOKEN_PROPERTY}} >> .github/test-app/src/test/resources/application.properties
+        shell: bash
 
       - name: Run automation tests with latest ngrok-spring-boot-starter version on test-app
         working-directory: ./.github/test-app/

.github/workflows/automation-test-macos.yml

@@ -19,9 +19,10 @@ jobs:
       - name: Silent install main project
         run: mvn --batch-mode --no-transfer-progress install -DskipTests
 
-      - name: Set current starter version in test-app
-        working-directory: ./.github/scripts/
-        run: sh set-current-starter-version.sh
+      - name: Add ngrok auth token application.properties
+        run: |
+          printf ${{secrets.NGROK_AUTH_TOKEN_PROPERTY}} >> .github/test-app/src/test/resources/application.properties
+        shell: bash
 
       - name: Run automation tests with latest ngrok-spring-boot-starter version on test-app
         working-directory: ./.github/test-app/

.github/workflows/automation-test-ubuntu.yml

@@ -59,19 +59,19 @@ compile('io.github.kilmajster:ngrok-spring-boot-starter:0.5.0')
 
 ##  Configuration
 ### 🚀 Minimal configuration
-#### `ngrok.enabled` - one required configuration property
+#### `ngrok.enabled`
 For simple http tunneling to springs default server port, **only one configuration property is required**. 
 There are many ways to provide spring config, for `application.property` based one, it will be:
 ```properties
 ngrok.enabled=true
 ```
-or yaml:
-```yaml
-ngrok:
-  enabled: true
+
+#### `ngrok.authToken`
+Ngrok requires `authToken` to be defined, to obtain one visit https://dashboard.ngrok.com/get-started/your-authtoken and then add it like below:
+```properties
+ngrok.authToken=<YOUR PERSONAL AUTH TOKEN>
 ```
-or you can pass java execution attribute, like: `java -jar your-app.jar --ngrok.enabled=true`, 
-or with spring-boot plugin `mvn spring-boot:run -Dspring-boot.run.arguments="--ngrok.enabled=true"`, or any other way 😊
+If you got already configured auth token in your ngrok config file there is no need to define this property.
 
 ✅ **All done, configuration is ready!** 
 
@@ -121,21 +121,6 @@ ngrok.command=http -region=us -hostname=dev.example.com 8000
 # should be = /home/user/.ngrok2/ngrok http -region=us -hostname=dev.example.com 8000
 ```
 
-## Ngrok API
-To access ngrok tunneling details you can use `NgrokApiClient` bean. Example below:
-```java
-@Autowired
-private NgrokApiClient ngrok;
-
-public void someMethod() {
-    # returns https tunnel URL or null in case ngrok is not running
-    String httpsTunnelUrl = ngrok.getHttpsTunnelUrl();
-
-    # returns http tunnel URL or null in case ngrok is not running
-    String httpTunnelUrl = ngrok.getHttpTunnelUrl();
-}
-```
-
 ##### Optional properties & descriptions
 ```properties
 # if you've got already running Ngrok instance somewhere else, you can specify its host & port, whoch defaults are: