diff --git a/public/img/logo-dark.svg b/public/img/logo-dark.svg index 068c330e..044be726 100644 --- a/public/img/logo-dark.svg +++ b/public/img/logo-dark.svg @@ -60,7 +60,7 @@ inkscape:groupmode="layer" id="layer1">
-
+
+ # Authentication You'll need to authenticate your requests to access any of the endpoints in the Protocol API. In this guide, we'll look at how authentication works. Protocol offers two ways to authenticate your API requests: Basic authentication and OAuth2 with a token — OAuth2 is the recommended way. {{ className: 'lead' }} diff --git a/src/pages/docs/introductions.mdx b/src/pages/docs/introductions.mdx index ffb4c30b..7c5e498f 100644 --- a/src/pages/docs/introductions.mdx +++ b/src/pages/docs/introductions.mdx @@ -9,7 +9,7 @@ export const description = -# NetBird Documentation +# NetBird Docs NetBird is a simple and fast alternative to corporate VPNs built on top of [WireGuard®](https://www.wireguard.com/) making it easy to create secure private networks for your organization or home. It requires near zero configuration effort leaving behind the hassle of opening ports, complex firewall rules, vpn gateways, and so forth. {{ className: 'lead' }} diff --git a/src/pages/docs/selfhosted-guide.mdx b/src/pages/docs/selfhosted-guide.mdx index ad9ad9f6..54ca8fb4 100644 --- a/src/pages/docs/selfhosted-guide.mdx +++ b/src/pages/docs/selfhosted-guide.mdx @@ -1,3 +1,6 @@ +import {HeroPattern} from "@/components/HeroPattern"; + + # Self-hosting Guide diff --git a/src/pages/errors.mdx b/src/pages/errors.mdx index 1dff2861..11452db3 100644 --- a/src/pages/errors.mdx +++ b/src/pages/errors.mdx @@ -1,6 +1,9 @@ +import {HeroPattern} from "@/components/HeroPattern"; export const description = 'In this guide, we will talk about what happens when something goes wrong while you work with the API.' + + # Errors In this guide, we will talk about what happens when something goes wrong while you work with the API. Mistakes happen, and mostly they will be yours, not ours. Let's look at some status codes and error types you might encounter. {{ className: 'lead' }} diff --git a/src/pages/introductions.mdx b/src/pages/introductions.mdx index 2f31c439..a428f699 100644 --- a/src/pages/introductions.mdx +++ b/src/pages/introductions.mdx @@ -12,7 +12,7 @@ export const sections = [ -# NetBird API +# NetBird REST API Use the NetBird Public API to manage users, peers, network rules and more from inside your application or scripts to automate the setup of your mesh network. {{ className: 'lead' }} @@ -23,14 +23,15 @@ Use the NetBird Public API to manage users, peers, network rules and more from i ## Getting started {{ anchor: false }} -To get started, create a new application in your [developer settings](#), then read about how to make requests for the resources you need to access using our HTTP APIs or dedicated client SDKs. When your integration is ready to go live, publish it to our [integrations directory](#) to reach the Protocol community. {{ className: 'lead' }} +To get started, it is recommended to create a [service user](#), that can later be used to communicate with the NetBird API. +To be able to send requests to our API you need [authenticate](#) on each request. This can be done either by Bearer token from you identity provider or by creating [personal access tokens](#) in the NetBird dashboard.{{ className: 'lead' }}
diff --git a/src/pages/quickstart.mdx b/src/pages/quickstart.mdx index 25aa239a..aa33038e 100644 --- a/src/pages/quickstart.mdx +++ b/src/pages/quickstart.mdx @@ -1,6 +1,9 @@ +import {HeroPattern} from "@/components/HeroPattern"; export const description = 'This guide will get you all set up and ready to use the Protocol API. We’ll cover how to get started an API client and how to make your first API request.' + + # Quickstart This guide will get you all set up and ready to use the Protocol API. We'll cover how to get started using one of our API clients and how to make your first API request. We'll also look at where to go next to find all the information you need to take full advantage of our powerful REST API. {{ className: 'lead' }}