라이선스 만료/오류 메시지 해석과 복구

서버가 라이선스 오류로 동작하지 않거나, API 키가 거부되나요? 바른은 사용 환경에 따라 라이선스 파일(폐쇄망)이나 API 키(클라우드) 방식으로 인증합니다. 이 문서로 메시지를 해석하고 복구해봐요.

증상

• 서버 기동 또는 요청 처리 시 라이선스 만료·오류 메시지가 나옵니다.
• API 키가 거부되거나 인증에 실패합니다.
• 폐쇄망 설치본에서 license.pem 관련 오류가 보입니다.

원인

인증 경로가 환경마다 다르다는 점을 먼저 이해하면 진단이 쉬워요.

해결

1. 어떤 환경인지부터 구분하세요. 클라우드라면 API 키, 폐쇄망 설치본이라면 license.pem이 인증의 핵심입니다.

2. 폐쇄망: license.pem을 확인하세요. 라이선스 파일이 정해진 위치에 있고 유효 기간 내인지 점검합니다. 파일이 var 디렉토리(예: ${BAREUN_ROOT}/var/license.pem)에 놓이는 구성을 기준으로 확인하세요. 만료됐다면 갱신된 라이선스로 교체해야 합니다.

3. 클라우드: API 키를 확인하세요. 키 형식은 koba-로 시작합니다. 키 등록은 등록 API(-reg)나 내장 웹의 API 키 등록 화면을 통해 진행합니다. 키가 정확한지, 환경 설정에 제대로 전달됐는지 확인하세요.

4. 무료 구간 초과 여부를 확인하세요. 클라우드 형태소 분석은 무료 구간이 50,000 어절입니다. 초과했다면 유료 전환이 필요합니다.

예방·팁

• 폐쇄망 운영이라면 license.pem의 만료일을 미리 캘린더에 적어두고 여유 있게 갱신하세요.
• API 키는 노출되지 않도록 안전하게 보관하고, 환경 변수나 보안 저장소로 주입하는 것이 좋습니다.

자주 묻는 질문

Q. 폐쇄망에서 라이선스 오류가 나요. 무엇을 봐야 하나요?

license.pem 파일이 정해진 위치에 있고 유효 기간 내인지 확인하세요. 보통 ${BAREUN_ROOT}/var/license.pem처럼 var 디렉토리에 놓입니다. 만료됐다면 갱신된 라이선스로 교체해야 합니다.

Q. 클라우드에서 API 키가 거부돼요.

키 형식이 koba-로 시작하는지, 정확히 입력했는지 확인하세요. 등록 API(-reg)나 내장 웹의 API 키 등록 화면으로 키를 등록할 수 있습니다. 무료 구간(50,000 어절) 초과 여부도 함께 점검하세요.

Q. 폐쇄망에서 맞춤법 검사기를 쓸 수 있나요?

맞춤법 검사기는 클라우드 전용 유료 기능입니다. 폐쇄망에서 쓰려면 별도의 유료 설치가 필요합니다.

Q. 무료 구간을 초과하면 어떤 메시지가 나오나요?

클라우드 형태소 분석은 무료 구간이 50,000 어절입니다. 한도를 넘으면 인증·사용량 관련 거부가 발생할 수 있어요. 초과했다면 유료 전환이 필요합니다. API 키가 정확한데도 거부된다면 무료 구간 초과 여부를 함께 점검하세요.