SIAM UB Authentication

This repository contains a project for educational purposes focused on SIAM UB Authentication, which is a web authentication system used by Faculty of Computer Science at Brawijaya University. The project utilizes web scraping techniques to retrieve information from the SIAM UB Authentication system. The implementation is done using PHP and the Guzzle HTTP library.

Disclaimer:
Please note that this project is intended solely for educational purposes and to demonstrate web scraping techniques. It should not be used for any malicious activities or unauthorized access to systems. The developers of this project are not responsible for any misuse or illegal actions undertaken by users.

Introduction
Features
Prerequisite
Installation
Usage
Contributing
License

Introduction

The SIAM UB Authentication project aims to retrieve information from the SIAM UB Authentication system, which is used for user authentication. The project demonstrates how web scraping techniques can be employed to automate the retrieval of data from web pages.

Features

[✅] Login to the SIAM UB Authentication system using provided credentials.
[✅] Scrape user information, such as name, nim, department, profile picture and others, from the authenticated user profile.
[⬜] Retrieve course information, including course codes, names, and schedules. Not supported yet.

Prerequisite

PHP: version 7.3 or higher
Guzzle: version 6 or higher
Composer

Installation

You can install the SIAM UB Authentication package via Composer. Run the following command in your terminal:

composer require mirzahilmi/siamub-auth

Usage

Authenticate with user credentials using SIAMUBAuth::authenticate() method:

<?php
use SIAMUBAuth\SIAMAuth;
use GuzzleHttp\Client;

$client = new Client();
$user = SIAMAuth::authenticate('22515xxxxxxxxxx', 'xxxxxxxx', $client);

echo get_class($user); // SIAMUBAuth\Models\Mahasiswa

Get user information:

echo $user->nim; // 22515xxxxxxxxxx

Available user informations:

echo $user->pasFoto;      // https://admisi.ub.ac.id/upload/**/*.jpg
echo $user->nim;          // 22515xxxxxxxxxx
echo $user->nama;         // Pemuja GKM
echo $user->jenjang;      // S1
echo $user->fakultas;     // Ilmu Komputer
echo $user->departemen;   // Sistem Informasi
echo $user->jurusan;      // Teknologi Informasi
echo $user->programStudi; // Teknologi Informasi
echo $user->seleksi;      // Seleksi Mandiri Brawijaya - xxxxx
echo $user->nomorUjian;   // 123456789
echo $user->status;       // 1

Important: Remember to use this project responsibly and only on systems for which you have proper authorization.

Contributing

Contributions to this project are welcome. If you encounter any issues or have ideas for improvements, feel free to open an issue or submit a pull request.

License

This project is licensed under the MIT License.

mirzahilmi/SIAMUB-Auth