Integrating PocketID with Services on Proxmox

Ethan

—

Integrating PocketID with Services on Proxmox

This guide will walk you through integrating PocketID with services running on your Proxmox environment, ensuring secure authentication.

1. Understanding PocketID
PocketID is a decentralized authentication service that allows users to log in without traditional passwords. You can integrate it with your web services to enhance security.

2. Setting Up PocketID on Your Services

Step 1: Create a PocketID Developer Account

Go to PocketID’s Developer Portal and sign up.
Create a new application.
Note your API credentials (Client ID and Secret).

Step 2: Install Required Packages on Your Proxmox Server

Ensure you have docker and docker-compose installed (if using Docker-based services).
Install dependencies for your web application (PHP, Node.js, or Python).
If using Nginx or Apache, ensure you have reverse proxy support enabled.

Step 3: Configure Your Service for PocketID

For most web services, you’ll need to configure OAuth 2.0 authentication. Below are common setups:

For Nginx Proxy Manager
If using Nginx Proxy Manager to secure services, you can use OpenID Connect:

Open your service’s configuration in Nginx Proxy Manager.
Under “Advanced”, add:

auth_request /auth; error_page 401 = /login;

Set up an authentication server that validates users via PocketID.

For Docker-Based Applications

Modify your service’s environment variables:

POCKETID_CLIENT_ID=your-client-id POCKETID_SECRET=your-client-secret POCKETID_REDIRECT_URI=https://your-service.domain.com/auth/callback

Restart the container:

docker-compose down && docker-compose up -d

For Standalone Applications

For apps using PHP, Node.js, or Python, use the PocketID SDK.

Node.js (Express Example):

js
const express = require('express');
const passport = require('passport');
const PocketIDStrategy = require('passport-pocketid');

passport.use(new PocketIDStrategy({
 clientID: process.env.POCKETID_CLIENT_ID,
 clientSecret: process.env.POCKETID_SECRET,
 callbackURL: "https://your-service.domain.com/auth/callback"
}, (accessToken, refreshToken, profile, done) => {
 return done(null, profile);
}));

app.get('/auth/pocketid', passport.authenticate('pocketid'));
app.get('/auth/callback', passport.authenticate('pocketid', { failureRedirect: '/' }), (req, res) => {
 res.redirect('/dashboard');
});

3. Testing and Troubleshooting

[] Ensure your service is running and accessible via HTTPS. [] Test login using PocketID and check logs for any authentication errors.
If you encounter issues, enable debug logs in your application.

4. Enhancing Security

Enable 2FA: Use PocketID’s built-in 2FA for additional security.

Restrict Access: Ensure only necessary services can authenticate using PocketID.

Monitor Logs: Regularly check logs to detect unauthorized access attempts.

5. Conclusion Integrating PocketID with your services on Proxmox enhances security and simplifies authentication. By following this guide, you can ensure a seamless and secure user login experience.

For more details, visit PocketID Documentation.