Coder Social home page Coder Social logo

deviceauth's Introduction

Build Status codecov Go Report Card Docker pulls

Mender: Device Authentication Service

Mender is an open source over-the-air (OTA) software updater for embedded Linux devices. Mender comprises a client running at the embedded device, as well as a server that manages deployments across many devices.

This repository contains the Mender Device Authentication service, which is part of the Mender server. The Mender server is designed as a microservices architecture and comprises several repositories.

Device Authentication is responsible for issuing, maintaining and verifying JWT authentication tokens used by devices in Mender API calls. A token is issued as a result of a successful bootstrap request, whereby the device presents its vendor-specific identity attributes, and can be admitted in the the system by the administrator. Each subsequent device-specific API call is then internally routed to this service for token verification. At any time, the administrator can also revoke the JWT in case it was compromised.

Mender logo

Getting started

To start using Mender, we recommend that you begin with the Getting started section in the Mender documentation.

Building from source

As the Mender server is designed as microservices architecture, it requires several repositories to be built to be fully functional. If you are testing the Mender server it is therefore easier to follow the getting started section above as it integrates these services.

If you would like to build the Device Authentication service independently, you can follow these steps:

git clone https://github.com/mendersoftware/deviceauth.git
cd deviceauth
go build

Configuration

The service can be configured by:

  • providing configuration file (supports JSON, TOML, YAML and HCL formatting). The default configuration file is provided to be downloaded from config.yaml.
  • setting environment variables. The service will check for a environment variable with a name matching the key uppercased and prefixed with "DEVICEAUTH_". Eg. for "listen" the variable name is "DEVICEAUTH_LISTEN".

Contributing

We welcome and ask for your contribution. If you would like to contribute to Mender, please read our guide on how to best get started contributing code or documentation.

License

Mender is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

Security disclosure

We take security very seriously. If you come across any issue regarding security, please disclose the information by sending an email to [email protected]. Please do not create a new public issue. We thank you in advance for your cooperation.

Connect with us

deviceauth's People

Contributors

bboozzoo avatar estenberg avatar gregoriodistefano avatar kacf avatar kjaskiewiczz avatar maciejmrowiec avatar marekswiecznik avatar mchalski avatar pasinskim avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.