# API 키 관리

앱 또는 에이전트에 대한 키 생성. 저장, 액세스 및 수명주기를 관리합니다.

Canonical 참고: https://flashdata.dev/ko/docs/guides/api-keys-and-permissions
검토: 2026-11-04 FlashData

<a id="create"></a>

## 1. 키 만들기

1. 확인된 계정에 로그인하고 API Keys를 엽니다. 이미 한 경우 공인된 키를 재사용합니다.
2. 앱과 환경을 위해 이름을 지정하고 expiry를 선택하고 소스를 선택하십시오. Google Search를 선택하여 첫 번째 검색 예입니다.
3. 키를 만들고 아래를 저장하십시오. 독립적 인 에이전트 및 생산 응용 프로그램 별도의 키를 제공하므로 개별적으로 수정할 수 있습니다.

- [API Keys 열기](https://flashdata.dev/app/api-keys)
- [가입하기](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md)

<a id="store"></a>

## 2. 키 저장

FlashData를 실행하는 방법을 선택하십시오. API 및 SDK 예제 읽기 FLASHDATA_API_KEY; CLI는 보호 된 프로필에서 키를 저장할 수 있습니다. 생산에서 비밀 가게에서 압도적 인 압도적 인.

### Bash · API / SDK

#### 이 맨끝을 위한 열쇠를 놓으십시오

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```


### PowerShell 7 · API / SDK

#### 이 맨끝을 위한 열쇠를 놓으십시오

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


### CLI

숨겨진 프롬프트에서 키를 붙여 넣는다. 이름의 프로필을 위해, --profile 이름을 여기에 추가하고 나중에 명령. 이전에 형성된 프로필은 로그인 --replace를 사용하여 키를 교체합니다.

#### 키 저장

```bash
flashdata auth login
```

- [CLI 설치](https://flashdata.dev/ko/docs/guides/flashdata-cli/reference.md#install)


<a id="verify"></a>

## 3. Verify 액세스

동일한 맨끝 또는 CLI 단면도에 있는 자유로운 체크를 실행하십시오. 키를 저장하는 방법을 일치하는 탭을 사용합니다.

### Bash / cURL

동일한 맨끝에 있는 이른 체크에서 FLASHDATA_API_KEY를 재사용하십시오.

#### 계정 읽기 JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

동일한 맨끝에 있는 이른 체크에서 FLASHDATA_API_KEY를 재사용하십시오.

#### 계정 읽기 JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


### CLI

저장된 CLI 액세스를 사용하십시오. 이름의 프로필에 --profile NAME을 각 명령에 추가합니다. 이 읽기는 쿼리 크레딧을 사용하지 않습니다.

#### 무료 계정 읽기

```bash
flashdata auth status
```

- [키 설정](https://flashdata.dev/ko/docs/guides/api-keys-and-permissions/reference.md#store)


<a id="verified"></a>

### 계정 및 소스 확인

HTTP는 이 필드를 직접 반환합니다. CLI JSON로 data.identity.identity 아래에서 찾아서 data.accessVerified: true를 요구하십시오.

| 확인 | 예상 결과 |
| --- | --- |
| accountId | 이 작업 부하를 소유하는 계정. |
| access | ready |
| scopes | 첫 번째 검색에 google_search를 포함합니다. |
| recurringAllowed | true는 예정된 소유자 일의 앞에. |

- [첫 번째 쿼리를 실행](https://flashdata.dev/ko/docs/guides/http-quickstart/reference.md)
- [균형 및 가격 확인](https://flashdata.dev/ko/docs/guides/credits-and-billing/reference.md)

<a id="permissions"></a>

### 소스 권한 작업 방법

키는 부여 된 소스 만 사용할 수 있습니다. 제품 선택은 가격과 별도로 구분됩니다. 계정의 모든 키는 구매한 크레딧을 포함하여 공유 잔액에서 지출합니다. 제한된 키는 자체 지출 캡이 없습니다. 미래 제품은 명시된 권한 부여를 요구합니다.

- [에이전트 권한 카탈로그](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md#permissions)

<a id="leak"></a>

## 키가 노출되면

1. 일치하는 콘솔 페이지에서 즉시 노출된 키를 되돌리고, 예정된 통화를 중지합니다.
2. 필요한 권한을 가진 교체를 만들고, 각 콜러의 비밀 저장소에 설치하고 위의 무료 검증을 실행합니다.
3. History 및 예기치 않은 활동에 대한 계정 사용 검토. 파일에서 비밀을 제거하지 않습니다.

- [API Keys](https://flashdata.dev/app/api-keys)
- [계정 사용](https://flashdata.dev/ko/docs/guides/usage-and-limits/reference.md#usage)

<a id="rotate"></a>

## 열쇠를 자전하십시오

1. 필요한 소스와 교체를 만들고 대상 환경에서 설치하십시오.
2. 위의 무료 검증을 반복하면 응용 프로그램 또는 스케줄러를 전환합니다. 각 의도한 호출기를 업데이트하십시오.
3. 콜러가 전환 한 후 오래된 키를 다시합니다. 노트북에 대한 비밀 업데이트는 배포 된 서비스를 업데이트하지 않습니다.

### CLI 키 교체 · 숨겨진 프롬프트로 붙여넣기

```bash
flashdata auth login --replace
flashdata auth status
```


<a id="revoke"></a>

## 관련 링크

예약된 통화를 중지, 일치하는 키 또는 연결을 수정, 다음 오래된 자격 증명으로 무료 검증을 반복. 그것은 거부되어야한다. 로컬로 로그아웃하지 않는 서버 액세스.

| 오시는 길 | 자주 묻는 질문 |
| --- | --- |
| 정규적인 API 열쇠 | API Keys |
| Claimed 에이전트 키 | Settings → Connected apps → Agent connections |
| MCP OAuth 보조금 | Settings → Connected apps |

- [API Keys](https://flashdata.dev/app/api-keys)
- [Connected apps](https://flashdata.dev/app/settings/connections)
- [인증 문제 해결](https://flashdata.dev/ko/docs/guides/headers-and-authentication/reference.md#errors)
