VDtN (Video Download to NAS) 1.1.1 업데이트

스크린샷 2025-11-17 12.27.41.png

1.1.1 업데이트 내역 추가

확장 프로그램 /rest 프록시 문제 수정

SSO 생성 계정 초기 비번 생성 기능 추가

 

확장 프로그램이나 봇을 사용하기 위해서는 비번이 필요한데

SSO 생성 계정은 비번이 따로 없죠

최초 비번 수정은 기존 비번 없이 변경이 가능합니다

계정설정 – 보안 탭에서 비번을 설정 후 확장 프로그램 이용하시면 됩니다

 

추후 확장 프로그램 전용 API 키 토큰 방식으로 업데이트를 생각하고 있습니다

VDtN이 1.1.1로 업데이트 됐습니다

피드백 받은 것들과 이것저것 수정이 됐습니다만

 

대표적인 것 몇가지를 설명 하자면 

SSO 로그인이 가능합니다

로컬 계정 로그인을 켜고 끌 수 있습니다

비상용 슈퍼 애드민 관리자 로그인은 상시 가능합니다

 

스크린샷 2025-11-17 11.01.39.png

프로필 메뉴가 정리 됐습니다 

 

 

스크린샷 2025-11-17 11.02.42.png

스크린샷 2025-11-17 12.30.20.png

닉네임이 추가 됐습니다 프로필이나 공개 게시판에 닉네임이 표시 됩니다

이메일 변경이 가능합니다 – SSO 연동 또는 SSO 로그인으로 계정이 생성 된 경우 수정이 불가 합니다

 

스크린샷 2025-11-17 13.06.50.png

 

스크린샷 2025-11-17 13.07.45.png

닉네임 변경은 슈퍼 애드민이 설정한 주기에 1번 변경 가능합니다

 

스크린샷 2025-11-17 13.09.33.png

슈퍼 애드민은 사용자 관리에서 사용자의 정보를 수정할 수 있습니다

스크린샷 2025-11-17 11.07.52.png

보안탭은 비번 변경이 가능하고요

 

스크린샷 2025-11-17 12.31.51.png

SSO 연동은 설정한 프로바이더로 로컬계정을 연결 할 수 있습니다

연동 해제도 가능하고요

SSO로 로그인을 했을 때 같은 이메일의 로컬 계정이 있다면 그 계정으로 로그인 됩니다

연동을 하려면 SSO 계정과 이메일이 일치해야 합니다

 

SSO로 로그인 했을 때 같은 이메일이 없다면 새 계정이 생성 됩니다

회원 가입이 막혀있으면 계정 생성이 안되니 로그인이 안됩니다

SSO 계정 생성으로 만들어진 계정은 연동 해제시 비번을 설정해서 로컬 계정으로 계속 사용가능합니다

로컬 계정으로 전환시 아이디는 이메일이 됩니다

 

스크린샷 2025-11-17 11.08.59.png

설정에 로컬 로그인 허용 버튼이 추가 됐고 SSO 설정 탭이 추가 됐습니다

 

image.png

SSO 설정 탭에서 여러 프로바이더 설정이 가능합니다

여러개를 동시에 사용 가능합니다

 

마소 SSO는 이제 만들기 좀 번거로워 졌더라고요

 

스크린샷 2025-11-17 12.34.04.png

범용 SSO는 생성 하면 프로바이더 목록에 따로 추가가 됩니다

여러개 생성이 가능 할 겁니다…

 

스크린샷 2025-11-17 11.22.19.png

 가이드에 이런저런 가이드와 리디렉션 콜백 주소가 있습니다

 

 가이드가 정확하지 않은 부분이 있을 수도 있겠지만 대충 따라서 설정 가능하더라고요

 

그 외에도 이런저런 부분들을 수정 했습니다

 

# ============================================================================
# 필수 설정 항목 (반드시 변경해야 하는 항목)
# ============================================================================

# JWT 시크릿 키 (프로덕션 환경에서 반드시 변경!)
# - 영문, 숫자, 하이픈(-), 언더스코어(_)만 사용 (특수문자 %@# 등은 피하세요)
# - 권장 길이: 32-64자
# - 예시: my-super-secret-jwt-key-for-production-2024
JWT_SECRET=change-this-secret-key-in-production

# SSO 암호화 키 (SSO 사용 시 필수)
# - OAuth2 클라이언트 시크릿을 데이터베이스에 암호화하여 저장할 때 사용
# - SSO를 사용하지 않으면 설정하지 않아도 됩니다
# 
# 권장 생성 방법 (가장 쉬움):
#   1) 애플리케이션을 먼저 실행하세요 (docker-compose up -d)
#   2) super_admin으로 로그인하세요
#   3) 설정 > SSO 탭에서 "암호화 키 생성" 버튼을 클릭하세요
#   4) 생성된 키를 복사하여 이 파일에 붙여넣으세요
#   5) docker-compose down && docker-compose up -d 로 재시작하세요
# 
# 대체 생성 방법:
#   - Python: python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
#   - Docker: docker exec -it video-download-to-nas-backend-1 python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
# 
# - 생성된 키 예시: gAAAAABk1234567890abcdefghijklmnopqrstuvwxyz==
# - ⚠️ 주의: 키를 변경하면 기존에 저장된 SSO 설정을 복호화할 수 없습니다!
SSO_ENCRYPTION_KEY=

# CORS 허용 출처 (쉼표로 구분된 목록)
# - 개발 환경: * (모든 출처 허용)
# - 프로덕션: 실제 도메인만 지정 (예: http://nas.example.com:3000,https://nas.example.com)
# - 시놀로지 예시: http://192.168.1.100:3000 또는 http://your-nas-domain:3000
ALLOWED_ORIGINS=*

# 백엔드 URL (OAuth2 리다이렉트 URI에 사용)
# - 시놀로지 예시: http://192.168.1.100:8000 또는 http://your-nas-domain:8000
# - 외부 접속 시: https://your-domain.com
BACKEND_URL=http://localhost:8000

# 프론트엔드 URL (인증 후 리다이렉트에 사용)
# - 시놀로지 예시: http://192.168.1.100:3000 또는 http://your-nas-domain:3000
# - 외부 접속 시: https://your-domain.com
FRONTEND_URL=http://localhost:3000

# HTTPS 강제 사용 (OAuth2 리다이렉트에 적용)
# - 개발 환경: false
# - 프로덕션 (HTTPS 사용 시): true
FORCE_HTTPS=false


# ============================================================================
# 고급 설정 (일반적으로 변경하지 않아도 되는 항목)
# ============================================================================

# 데이터베이스 경로
# - Docker 환경에서는 변경하지 마세요
# - 데이터는 /app/data 볼륨에 저장됩니다
DATABASE_URL=sqlite:////app/data/vdtn.db


# ============================================================================
# 참고 사항
# ============================================================================
# 
# 기타 설정 (Rate Limiting, 사용자 등록, 할당량 등)은
# super_admin으로 로그인 후 설정 페이지에서 변경할 수 있습니다.
#
# SSO 제공자 설정 (Google, Microsoft, GitHub 등)도
# 설정 페이지의 SSO 탭에서 구성할 수 있습니다.
#

.env가 변경이 좀 됐습니다

자세한 주석을 추가 했으니 읽이보시고 수정하시길 바랍니다

참고로 jwt 토큰은 이전에 쓰던 걸 이어서 써야 기존 디비를 계속 사용 가능 합니다

 

그리고 디비 마이그레이션이 자동으로 진행 됩니다만 혹시모르니 디비 백업 후 진행하세요

 

 

댓글 남기기

이메일 주소는 공개되지 않습니다. 필수 항목은 *(으)로 표시합니다