Merge pull request #2 from wulkanowy/readme

Create English README
This commit is contained in:
Dominik Korsa 2021-02-09 15:29:02 +01:00 committed by GitHub
commit b55623a03c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 20 additions and 0 deletions

18
README.en.md Normal file
View file

@ -0,0 +1,18 @@
[Polska wersja README](README.md)
# Wulkanowy Bridge
## What is Wulkanowy Bridge?
Wulkanowy Bridge is a service, which allows apps to access data from VULCAN UONET+ using a well-documented API.
## Project features
- Uses [wulkanowy/sdk-node](https://github.com/wulkanowy/sdk-node)
- Implements **OAuth2.0** protocol
- API uses **GraphQL** and supports [schema introspection](https://graphql.org/learn/introspection/)
- Apps (clients) don't have access to user's login and password
- [We encrypt data stored in our database, to limit the scope of an attack](#how-does-wulkanowy-bridge-protect-login-info-of-users)
- Apps specify the access scope and user is informed about it
## How does Wulkanowy Bridge protect login info of users?
To reduce the consequences of unauthorised access to our server or database, login and session information is encrypted in the database. The key needed to decrypt the information is in the access token generated for an app, so accessing the database doesn't, by itself, allow to decrypt the information.
**Wulkanowy Bridge ma możliwość odszyfrowania tych informacji wyłącznie podczas zapytania przez aplikację (przy każdym zapytaniu wysyłany jest token)**
**Wulkanowy Bridge can decrypt the information only when a request is made by an app (the access token is sent with every request)**

View file

@ -1,4 +1,6 @@
[English version of README](README.en.md)
# Wulkanowy Bridge # Wulkanowy Bridge
## Czym jest Wulkanowy Bridge? ## Czym jest Wulkanowy Bridge?
Wulkanowy Bridge to serwis umożliwiający dostęp do danych z dziennika VULCAN UONET+ poprzez udokumentowane API. Wulkanowy Bridge to serwis umożliwiający dostęp do danych z dziennika VULCAN UONET+ poprzez udokumentowane API.