Skip to content

Commit

Permalink
Update NS_Followers.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Navid200 authored Dec 9, 2024
1 parent 395ad83 commit 06acac9
Showing 1 changed file with 9 additions and 28 deletions.
37 changes: 9 additions & 28 deletions docs/Nightscout/NS_Followers.md
Original file line number Diff line number Diff line change
@@ -1,44 +1,25 @@
---
layout: GCNS
permalink: "/docs/Nightscout/NS_Followers.html"
---

## Setting up followers on Google Cloud
[Google Cloud Nightscout](./GoogleCloud.md) >> Setting up followers

You can always use a web browser or xDrip to follow and see the readings from your Nightscout site.
Using tokens for following is the most secure method. Giving permission to the world to access your site is not.
Also, giving the world permission to access your site may allow crawlers to access it, which will increase traffic. In order to keep your Nighsctout project free, you need to minimize traffic.
<br/>
<br/>

---

#### **Setting up Nightscout tokens for your followers**
You can always use a web browser to see the readings from your Nightscout site. All you need is to enter the hostname in the browser and authenticate using API_SECRET or token when requested.

Use a web browser to access your Nightscout (https://hostname) and authenticate again if needed (see [Setting up Nightscout](./NS_setup)).
Click on the top right menu button and select "Admin Tools".
![](./images/AdminTools.png)
Using tokens is the most secure method. Giving permission to the world to access your site is not.
How you can manage tokens is described [here](./Tokens.md).

Click on "Add new Subject".
![](./images/Tokens.png)
In the form that opens, enter a name. under "Roles", copy roles from the table below it. For example, for a follower that is only supposed to see readings and nothing else, only enter "readable" without quotes as you can see in the previous image. You can enter a combination of different roles by separating them with `,`.
You can add an optional comment and save. Take note of the access token.

An example token that can only read is shown below.
![](./images/TokenReadable.png)

You can create multiple tokens with specific permissions for each to use for different followers.
Also, giving the world permission to access your site may allow crawlers to access it, which will increase traffic. In order to keep your Nighsctout project free, you need to minimize traffic.
<br/>
<br/>

---

#### **Setting up xDrip as a follower**
#### **Setting up a follower app**

In the follower xDrip, choose "Nightscout Follower" as the hardware data source.
Under "Nightscout Follow URL", enter https://Token@hostname assuming Token is the token you generated as explained above, and hostname is your FreeDNS hostname.

If it doesn't work, try the following in a browser on the follower phone, where Token is the token you generated as explained above. If it doesn't work, the token may be wrong.
https://hostname/?token=Token
There are apps you can use to follow Nightscout.
How you need to set up an app to follow Nightscout varies depending on the app. You need to refer to the app instructions.

How you can use xDrip as a Nightscout follower is explained [here](./Follow/FollowNightscout.md).

0 comments on commit 06acac9

Please sign in to comment.