Skip to content

Latest commit

 

History

History
44 lines (32 loc) · 2.39 KB

README.md

File metadata and controls

44 lines (32 loc) · 2.39 KB

Dummy Bakaláři 🤖

Bakaláři server for faking authentication in the mobile app Bakaláři Online📱 (Apple, Google, Aptoide).

About 🤔

Most companies offering student discounts verify your eligibility by checking if you are authenticated in the Bakaláři Online mobile app. This project is a proof-of-concept implementation of all Bakaláři API endpoints required for the authentication.

Usage 💻

After installing the official app, you can choose between creating a new profile and using a one-time sign-in option. I recommend using the one-time sign-in option just for testing.

When filing in the information, use the URL of the dummy server as the server name. For example, in the picture below I used my demo server (https://dub.fosny.eu). I also entered "DISPLAY NAME" as username and "CLASS NAME" as the password.

Screenshot of the mobile log-in screen with filled information

After clicking the "Sign in" button, it will redirect you to the user page with your username as the student's name and password as the student's class.

NOTE: Clicking on any module except "Dokumenty" will open a blank page saying an error occurred as the dummy server responds with a 400 status code to any unknown request.

Screenshot of the mobile log-in screen with filled information

To change your student name or class name, if you

  • created a profile
    1. Open left sidebar
    2. Click on your student name to get to the "select profile" page
    3. Press the edit button next to your profile
    4. Change your profile name to your needs
  • used one-time sign-in: Sign out and log back in with different credentials

Docker/Podman compose 🚚

An example config file to expose a service at port 8080:

NOTE: Bakaláři Online requires HTTPS protocol and will fail with plain HTTP or a self-signed certificate. You have to put this service behind a proxy with a valid certificate. (I recommend using Let's Encrypt🔒)

version: "3"

services:
  dummy-bakalari:
    build: https://gitlab.com/vfosnar/dummy-bakalari.git#main
    restart: always
    environment:
      - "APP_ADDRESS=:80"
    ports:
      - "8080:80"