mirzahilmi / siamub-auth
MirzaHilmi/SIAMUB-Auth is a PHP Composer package designed for educational purposes. It allows you to authenticate and retrieve information from the SIAM UB Authentication system, a web authentication system used by college. This package utilizes web scraping techniques and the Guzzle HTTP library to
Requires
- php: >=7.3
- guzzlehttp/guzzle: >=6.0
README
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.
Table of Contents
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
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.