메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

시크릿 도구는 Replit 앱의 민감한 정보인 시크릿 — API 키, 인증 토큰, 데이터베이스 연결 문자열 등 — 을 저장하고 암호화합니다. 시크릿을 추가하면 도구가 자동으로 데이터를 암호화하고 Replit 앱에 환경 변수로 제공합니다. 이 방법을 사용하면 코드에 시크릿을 하드코딩하지 않고 노출 위험을 줄일 수 있습니다.
코드베이스에 시크릿을 하드코딩하면 다음 시나리오에서 실수로 노출될 수 있습니다:
  • 공개 Replit 앱이나 복사-붙여넣기를 통해 코드를 다른 사람과 공유할 때
  • 공개 저장소의 버전 관리에 코드를 커밋할 때
  • 코드를 라이브 스트리밍하거나 화면 공유할 때
시크릿 도구를 사용해 자격증명 노출 걱정 없이 코드를 공유하세요.
screenshot of the Secrets tool

기능

시크릿에는 다음 기능이 포함됩니다:
  • 엔드투엔드 암호화: 저장 시 AES-256 암호화, 전송 시 TLS 암호화를 사용해 자동으로 데이터 보호
  • 앱 수준 시크릿: 특정 Replit 앱에 대한 시크릿 저장 및 관리
  • 계정 수준 시크릿: 모든 Replit 앱에서 사용할 수 있는 시크릿 저장 및 관리
  • 환경 변수 접근: 환경 변수를 사용해 코드에서 시크릿에 접근
  • 협업 접근: 협업자 및 팀원과 시크릿 공유

사용 방법

시크릿은 정적 배포를 제외한 모든 배포 유형에서 사용할 수 있습니다.
시크릿 Project Editor 도구에서 시크릿에 접근할 수 있습니다.
왼쪽 도구 도크에서:
  1. All tools icon All tools를 선택해 Project Editor 도구 목록을 확인하세요.
  2. Secrets icon Secrets를 선택하세요.
검색 바에서:
  1. 상단의 magnifying glass icon 돋보기를 선택해 검색 도구를 여세요
  2. “Secrets”를 입력해 도구를 찾고 결과에서 선택하세요.

앱 시크릿 관리

Secrets 패널의 App Secrets 탭에서 앱 수준 시크릿을 관리할 수 있습니다. 이 탭에는 Replit 앱과 연결된 모든 시크릿 목록이 표시됩니다.
시크릿을 추가하려면:
  1. New Secret을 선택하세요.
  2. 시크릿의 이름인 Key와 시크릿 자체인 Value를 입력하세요.
  3. Add Secret을 선택해 항목을 저장하세요.
시크릿을 편집하려면:
  1. 시크릿 옆의 three vertical dots icon 세로 점 메뉴를 선택하세요.
  2. 컨텍스트 메뉴에서 Edit를 선택하세요.
  3. Key 또는 Value 필드의 텍스트를 업데이트하고 Update Secret을 선택해 변경 사항을 저장하거나 Cancel을 선택해 변경을 취소하세요.
탭 하단의 Edit as JSON 또는 Edit as .env를 선택해 앱 시크릿 전체 목록을 수정할 수도 있습니다.
시크릿을 보려면 시크릿 옆의 eye icon 눈 아이콘을 선택하세요.시크릿을 숨기려면 eye with a slash icon 슬래시가 있는 눈 아이콘을 선택하세요.
시크릿을 삭제하려면 시크릿 옆의 three vertical dots icon 세로 점 메뉴를 선택하고 Delete를 선택하세요.

계정 시크릿 관리

Secrets 패널의 Account Secrets 탭에서 계정 수준 시크릿을 관리할 수 있습니다. 이 탭에는 Replit 계정과 연결된 시크릿 목록만 표시됩니다.
계정 수준 시크릿을 추가하려면:
  1. Account Secrets 탭으로 이동하세요.
  2. gear icon 아이콘을 선택해 Settings를 열고 계정 수준 시크릿을 관리하세요.
  3. New Secret을 선택해 시크릿을 추가하세요.
  4. 시크릿의 이름인 Key와 시크릿 자체인 Value를 입력하세요.
  5. Save를 선택해 항목을 저장하세요.
시크릿을 편집하려면:
  1. 시크릿 옆의 pencil icon 연필 아이콘을 선택하세요.
  2. Key 또는 Value 필드의 텍스트를 업데이트하고 Save를 선택해 변경 사항을 저장하거나 Cancel을 선택해 변경을 취소하세요.
시크릿을 보려면 시크릿 옆의 eye icon 눈 아이콘을 선택하세요.시크릿을 숨기려면 eye with a slash icon 슬래시가 있는 눈 아이콘을 선택하세요.
  1. 시크릿 옆의 pencil icon 연필 아이콘을 선택하세요.
  2. Delete를 선택하세요.

코드에서 시크릿에 접근하기

import os
print(os.getenv("MY_SECRET"))

시크릿 가시성 관리

시크릿 가시성은 Replit 앱에 대한 접근 권한과 앱을 작성했는지 여부에 따라 달라집니다. 다음 옵션 중 하나를 사용해 Replit 앱을 공유할 수 있습니다:
  • Multiplayer: Replit 사용자를 초대해 실시간으로 협업하기
  • Cover page: Replit 앱의 미리 보기와 리믹스 옵션 표시하기
  • Remix: 개인 또는 조직의 Replit 앱을 공개로 만들어 다른 사람이 자신만의 버전을 만들 수 있게 하기
다음 표는 다양한 시나리오에서 시크릿 이름과 값의 가시성을 보여줍니다:
접근 방법대상이름 볼 수 있음값 볼 수 있음
MultiplayerMultiplayer 협업자
Multiplayer조직 구성원 (Owner 역할)
Multiplayer조직 구성원 (비Owner)
Cover Page모든 방문자
Remix자신의 Replit 앱을 리믹스하는 소유자/협업자
Remix비소유자/협업자가 Replit 앱 리믹스
Remixcover page에서 리믹스하는 모든 사용자
Organization RemixOwner 역할이 있는 조직 구성원
Organization RemixOwner 역할이 없는 조직 구성원
Owner 역할이 없는 조직 구성원은 Replit 앱에서 시크릿 값을 볼 수 없지만, 환경 변수를 출력해 값에 접근할 수 있습니다.

데이터베이스 관련 시크릿

Replit의 데이터베이스를 추가하면 Project Editor가 자동으로 다음 시크릿을 생성합니다:
시크릿설명
DATABASE_URLSQL 데이터베이스 연결 문자열
레거시 Neon 개발 데이터베이스에는 PGHOST, PGUSER, PGPASSWORD, PGDATABASE, PGPORT도 포함될 수 있습니다. 현재 Replit 개발 데이터베이스는 대신 DATABASE_URL을 사용합니다.
Replit 앱의 모든 환경 변수를 보려면 Shell Project Editor 도구에서 printenv를 실행하거나 코드에서 출력하세요.

사전 정의된 환경 변수

Replit은 앱에서 접근할 수 있는 다음 환경 변수를 자동으로 설정합니다:
환경 변수설명
REPLIT_DOMAINSReplit 앱과 연결된 모든 도메인의 쉼표로 구분된 목록
REPLIT_USER현재 편집자의 사용자 이름 (Multiplayer 세션에서는 다를 수 있음)
REPLIT_DEPLOYMENT코드가 게시된 앱에서 실행 중이면 1로 설정, 그렇지 않으면 미설정
REPLIT_DEV_DOMAIN배포 URL과 다른 replit.dev 도메인의 개발 URL
이것들은 시크릿 도구에 나열되지 않지만, os.environ 객체를 사용하거나 Shell에서 printenv를 실행해 코드에서 접근할 수 있습니다.