---
title: "ncp-iam-authenticator 설치"
slug: "k8s-iam-auth-ncp-iam-authenticator"
tags: ["Ncloud Kubernetes Service"]
updated: 2026-09-17T09:09:21Z
published: 2026-09-17T09:09:21Z
canonical: "guide-fin.ncloud-docs.com/k8s-iam-auth-ncp-iam-authenticator"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ncp-iam-authenticator 설치

VPC 환경에서 이용 가능합니다.

Ncloud Kubernetes Service는 `ncp-iam-authenticator`를 통해 IAM 인증을 제공합니다. IAM 인증을 통해 kubectl 명령을 사용하려면 `ncp-iam-authenticator`를 설치하고 이를 인증에 사용하도록 kubectl 설정 파일을 수정해야 합니다.

          참고

          

API 접근 제어를 사용하는 경우 메인 계정으로는 IAM 인증을 지원하지 않으며, 서브 계정만 IAM 인증이 가능합니다.

## macOS 설치

macOS에 `ncp-iam-authenticator`를 설치하는 방법은 다음과 같습니다.

#### [Homebrew](https://brew.sh/)로 설치

```
brew tap NaverCloudPlatform/tap
brew install ncp-iam-authenticator
```

#### 직접 다운로드하여 설치

1. `ncp-iam-authenticator` 바이너리를 다운로드해 주십시오. (Arm 버전을 다운로드하려면 명령을 실행하기 전에 amd64를 arm64로 변경해 주십시오.)

```
curl -o ncp-iam-authenticator -L https://github.com/NaverCloudPlatform/ncp-iam-authenticator/releases/latest/download/ncp-iam-authenticator_darwin_amd64
```
2. (선택) SHA-256 SUM을 사용하여 다운로드한 바이너리 파일을 확인할 수 있습니다.
  1. `ncp-iam-authenticator` 바이너리 파일의 SHA-256 합계를 확인합니다.

```
openssl sha1 -sha256 ncp-iam-authenticator
```
  2. SHA-256 SUM을 다운로드합니다.

```
https://github.com/NaverCloudPlatform/ncp-iam-authenticator/releases/latest/download/ncp-iam-authenticator_SHA256SUMS
```
  3. 두 값이 일치하는지 확인합니다.
3. 바이너리에 실행 권한을 추가해 주십시오.

```
chmod +x ./ncp-iam-authenticator
```
4. `$HOME/bin/ncp-iam-authenticator`를 생성하고 `$PATH`에 추가해 주십시오.

```
mkdir -p $HOME/bin && cp ./ncp-iam-authenticator $HOME/bin/ncp-iam-authenticator && export PATH=$PATH:$HOME/bin
```
5. Shell Profile에 `PATH`를 추가해 주십시오.
  - bash

```
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bash_profile
```
  - zsh

```
echo 'export PATH=$PATH:$HOME/bin' >> ~/.zshrc
```
6. `ncp-iam-authenticator` 바이너리가 정상 동작하는지 테스트해 주십시오.

```
ncp-iam-authenticator help
```

## linux 설치

linux에 `ncp-iam-authenticator`를 설치하는 방법은 다음과 같습니다.

1. `ncp-iam-authenticator` 바이너리를 다운로드해 주십시오.(Arm 버전을 다운로드하려면 명령을 실행하기 전에 amd64를 arm64로 변경합니다.)

```
curl -o ncp-iam-authenticator -L https://github.com/NaverCloudPlatform/ncp-iam-authenticator/releases/latest/download/ncp-iam-authenticator_linux_amd64
```
2. (선택) SHA-256 SUM을 사용하여 다운로드한 바이너리 파일을 확인할 수 있습니다.
  1. `ncp-iam-authenticator` 바이너리 파일의 SHA-256 합계를 확인합니다.

```
openssl sha1 -sha256 ncp-iam-authenticator
```
  2. SHA-256 SUM을 다운로드 합니다.

```
curl -o ncp-iam-authenticator.sha256 -L https://github.com/NaverCloudPlatform/ncp-iam-authenticator/releases/latest/download/ncp-iam-authenticator_SHA256SUMS
```
  3. 두 값이 일치하는지 확인합니다.
3. 바이너리에 실행 권한을 추가해 주십시오.

```
chmod +x ./ncp-iam-authenticator
```
4. `$HOME/bin/ncp-iam-authenticator`를 생성하고 `$PATH`에 추가해 주십시오.

```
mkdir -p $HOME/bin && cp ./ncp-iam-authenticator $HOME/bin/ncp-iam-authenticator && export PATH=$PATH:$HOME/bin
```
5. Shell Profile에 `PATH`를 추가해 주십시오.
  - bash

```
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bash_profile
```
6. `ncp-iam-authenticator` 바이너리가 정상 동작하는지 테스트해 주십시오.

```
ncp-iam-authenticator help
```

## windows 설치

windows `ncp-iam-authenticator`를 설치하는 방법은 다음과 같습니다.

1. PowerShell 터미널에서 `ncp-iam-authenticator` 바이너리를 다운로드해 주십시오.

```
curl -o ncp-iam-authenticator.exe -L https://github.com/NaverCloudPlatform/ncp-iam-authenticator/releases/latest/download/ncp-iam-authenticator_windows_amd64.exe
```
2. (선택) SHA-256 SUM을 사용하여 다운로드한 바이너리 파일을 확인할 수 있습니다.
  1. `ncp-iam-authenticator` 바이너리 파일의 SHA-256합계를 확인합니다.

```
Get-FileHash ncp-iam-authenticator.exe
```
  2. SHA-256 SUM을 다운로드합니다.

```
curl -o ncp-iam-authenticator.sha256 -L https://github.com/NaverCloudPlatform/ncp-iam-authenticator/releases/latest/download/ncp-iam-authenticator_SHA256SUMS
```
  3. 두 값이 일치하는지 확인합니다.
3. C:\bin과 같이, 새 폴더를 생성해 주십시오.
4. ncp-iam-authenticator.exe 실행 파일을 새 폴더로 복사해 주십시오.
5. 사용자 또는 시스템 PATH 환경 변수를 편집하여 PATH에 새 폴더를 추가해 주십시오.
6. PowerShell 터미널을 닫고 새 PATH 변수를 가져오기 위해 새 터미널을 열어 주십시오.
7. `ncp-iam-authenticator` 바이너리가 정상 동작하는지 테스트해 주십시오.

```
ncp-iam-authenticator help
```

`ncp-iam-authenticator`가 설치가 완료되었다면 kubeconfig를 추가해야 합니다. [IAM 인증 kubeconfig 생성](/docs/k8s-iam-auth-kubeconfig)을 참조해 주십시오.