OpenProof / 설치

깨끗한 서버에서 실행 중인 아이덴티티 서비스까지.

패키지 installer는 release package, PostgreSQL, 암호화 자료, 첫 owner, 이메일 전달, provider, Nginx, TLS 및 최종 health check를 처리합니다.

빠른 설치

shell권장

curl -fsSL https://genyleap.com/install/openproof | sudo sh

bootstrap endpoint는 지원 운영체제와 CPU 아키텍처를 감지하고 일치하는 사전 빌드 OpenProof bundle을 내려받아 공개된 SHA-256 manifest로 검증합니다. production installer는 compiler를 설치하거나 조용히 source build로 전환하지 않습니다. 일치하는 검증된 bundle이 없으면 설치가 명시적으로 실패합니다.

Ubuntu 24.04+Debian 13+AMD64ARM64systemd

wizard가 구성하는 항목

Identity origin

공개 domain, 조직 identity 및 초기 owner account를 선택하세요.

PostgreSQL 및 secrets

로컬 데이터베이스를 설치하거나 기존 데이터베이스에 연결하세요. OpenProof는 제한된 filesystem permission으로 signing, encryption, pepper, audit secret을 생성합니다.

이메일 전달

인증된 SMTP relay, 직접 Postfix, 기존 HTTPS delivery webhook을 사용하거나 전달 설정을 나중에 구성할 수 있습니다.

인증 프로바이더

필요한 provider만 선택하세요. 이후 wizard가 해당 Client ID, Client Secret, API key 또는 RPC 구성을 요청합니다.

TLS 및 ingress

Nginx를 Let’s Encrypt로 구성하거나 기존 인증서를 사용하거나 OpenProof를 외부 HTTPS ingress 뒤에 배치하세요.

검증

setup 완료 전에 configuration, systemd, local readiness 및 public identity origin을 확인합니다.

Provider credential

각 redirect provider는 identity domain에서 생성된 callback을 사용합니다:

callbackupstream에 등록

https://identity.example.com/auth/federated/callback

프로바이더	setup 필요 항목
Google	Client ID + Client Secret
GitHub	Client ID + Client Secret
Microsoft	Tenant ID + Client ID + Client Secret
Apple	Services ID + client-secret JWT
LinkedIn	Client ID + Client Secret
Telegram	Client ID + Client Secret
X	API Key + API Secret
Ethereum	선택적 smart-wallet RPC mapping
Farcaster	Optimism RPC endpoint

credential은 공개 configuration 및 repository 외부에 저장됩니다. 선택하지 않은 provider는 구성되지 않은 상태로 둡니다.

이메일 전달

OpenProof는 verification challenge를 생성하고 검증하지만 메시지 전달은 별도의 인증된 경계 뒤에 둡니다.

흐름전달 경계

OpenProof
    ↓
authenticated delivery adapter
    ↓
SMTP / Postfix / your HTTPS webhook
    ↓
user inbox

직접 메일 전달은 installer 외부의 DNS 설정이 필요합니다.

직접 Postfix 전달을 선택했다면 발신 domain에 PTR/rDNS, SPF, DKIM, DMARC를 구성하세요. installer는 로컬 서비스를 설정할 수 있지만 공개 DNS 및 provider 제어는 operator 책임으로 남습니다.

설치 옵션

shellpackage만

curl -fsSL https://genyleap.com/install/openproof | \
  sudo sh -s -- --no-setup

sudo openproof setup

shell특정 버전

curl -fsSL https://genyleap.com/install/openproof | \
  sudo sh -s -- --version 1.1.0

shellrelease candidate

curl -fsSL https://genyleap.com/install/openproof | \
  sudo sh -s -- --channel rc

설치 후

shell관리

sudo openproof status
sudo openproof doctor
sudo openproof config
sudo openproof config providers
sudo openproof update
sudo openproof backup /var/backups/openproof.dump

변경 후 doctor를 사용하세요.

openproof doctor binary, configuration, service state, PostgreSQL, Nginx, local/public readiness 및 OIDC discovery를 확인합니다.