인증#

사용자 관리, n8n의 내장 인증 기능을 설정하여 n8n을 보호할 수 있습니다.

n8n은 LDAP 및 SAML을 지원합니다.

자격증명 덮어쓰기#

사용자에게 OAuth 로그인을 제공하려면 전역적으로 자격증명을 덮어쓸 수 있습니다. 이 자격증명 데이터는 사용자에게 표시되지 않지만 백엔드에서 자동으로 사용됩니다.

편집기 UI에서 n8n은 덮어쓴 모든 필드를 기본적으로 숨깁니다. 이는 사용자가 자격증명의 "연결" 버튼을 눌러 OAuth를 사용하여 인증할 수 있음을 의미합니다.

n8n은 자격증명 덮어쓰기를 적용하는 두 가지 방법을 제공합니다: 환경 변수 사용 및 REST API 사용.

환경 변수 사용#

CREDENTIALS_OVERWRITE_DATA를 { CREDENTIAL_NAME: { PARAMETER: VALUE }}로 설정하여 환경 변수를 사용하여 자격증명 덮어쓰기를 설정할 수 있습니다.

REST API 사용#

권장 방법은 사용자 정의 REST 엔드포인트를 사용하여 데이터를 로드하는 것입니다. CREDENTIALS_OVERWRITE_ENDPOINT를 이 엔드포인트를 사용할 수 있게 할 경로로 설정합니다. CREDENTIALS_OVERWRITE_ENDPOINT_AUTH_TOKEN을 설정하여 엔드포인트 접근에 토큰을 요구할 수 있습니다. 이 토큰이 구성되면 Authorization 헤더에 Bearer 토큰으로 포함된 경우에만 엔드포인트에 접근할 수 있습니다.

예를 들어:

1. n8n이 실행되는 환경의 환경 변수를 설정하여 엔드포인트를 활성화합니다:

   export CREDENTIALS_OVERWRITE_ENDPOINT=send-credentials
   

2. 그런 다음 덮어쓸 자격증명이 포함된 JSON 파일이 필요합니다. 예를 들어, Asana 및 GitHub의 자격증명을 덮어쓰기 위한 oauth-credentials.json 파일은 다음과 같습니다:

   {
       "asanaOAuth2Api": {
           "clientId": "<id>",
           "clientSecret": "<secret>"
       },
       "githubOAuth2Api": {
           "clientId": "<id>",
           "clientSecret": "<secret>"
       }
   }
   

3. 그런 다음 curl을 사용하여 인스턴스에 적용합니다:

   curl -H "Content-Type: application/json" --data @oauth-credentials.json http://localhost:5678/send-credentials
   

CREDENTIALS_OVERWRITE_ENDPOINT_AUTH_TOKEN이 secure-token으로 설정된 경우, curl 명령은 다음과 같습니다:

```sh
curl -H "Content-Type: application/json" -H "Authorization: Bearer secure-token" --data @oauth-credentials.json http://localhost:5678/send-credentials
```

영속성#

데이터베이스에 자격증명 덮어쓰기를 저장하고 멀티 인스턴스/큐 모드에서 모든 워커에 자동으로 전파하려면 다음을 활성화합니다:

export CREDENTIALS_OVERWRITE_PERSISTENCE=true

활성화되면 n8n은 암호화된 덮어쓰기를 settings 테이블에 저장하고 워커가 최신 값을 다시 로드하도록 reload-overwrite-credentials 이벤트를 브로드캐스트합니다. 비활성화되면 덮어쓰기는 로드한 프로세스의 메모리에 남아 있으며 워커에 전파되거나 재시작 후에도 보존되지 않습니다.

환경 변수#

n8n에는 설정할 수 있는 많은 환경 변수가 있습니다. 다음은 호스팅 솔루션에 가장 관련성이 높은 환경 변수입니다:

백엔드 훅#

특정 작업이 실행될 때마다 n8n이 실행하는 외부 훅을 정의할 수 있습니다. 예를 들어, 데이터 로깅, 데이터 변경 또는 오류를 발생시켜 작업을 금지하는 데 사용할 수 있습니다.

사용 가능한 훅#

훅 등록#

훅 함수가 포함된 훅 파일을 등록하여 훅을 설정합니다. 훅을 등록하려면 환경 변수 EXTERNAL_HOOK_FILES를 설정합니다.

변수를 단일 파일로 설정할 수 있습니다:

EXTERNAL_HOOK_FILES=/data/hook.js

또는 콜론으로 구분된 여러 파일을 포함하도록 설정할 수 있습니다:

EXTERNAL_HOOK_FILES=/data/hook1.js:/data/hook2.js

백엔드 훅 파일#

훅 파일은 다음 형식을 가진 일반 JavaScript 파일입니다:

module.exports = {
    "frontend": {
        "settings": [
            async function (settings) {
                settings.oauthCallbackUrls.oauth1 = 'https://n8n.example.com/oauth1/callback';
                settings.oauthCallbackUrls.oauth2 = 'https://n8n.example.com/oauth2/callback';
            }
        ]
    },
    "workflow": {
        "activate": [
            async function (workflowData) {
                const activeWorkflows = await this.dbCollections.Workflow.count({ active: true });

                if (activeWorkflows > 1) {
                    throw new Error(
                        'Active workflow limit reached.'
                    );
                }
            }
        ]
    }
}

백엔드 훅 함수#

훅 또는 훅 파일에는 여러 훅 함수가 포함될 수 있으며, 모든 함수는 차례로 실행됩니다.

훅 함수의 파라미터가 객체인 경우 해당 파라미터의 데이터를 변경하여 n8n의 동작을 변경할 수 있습니다.

this.dbCollections를 사용하여 모든 훅 함수에서 데이터베이스에 접근할 수도 있습니다(백엔드 훅 파일의 코드 샘플 참조).

프론트엔드 외부 훅#

백엔드 외부 훅처럼, 사용자가 특정 작업을 수행할 때마다 n8n에 의해 실행되는 외부 훅을 프론트엔드 코드에 정의할 수 있습니다. 예를 들어, 데이터를 로깅하고 변경하는 데 사용할 수 있습니다.

사용 가능한 훅#

훅 등록#

페이지에 훅 스크립트를 로드하여 훅을 설정할 수 있습니다. 한 가지 방법은 프로젝트에 훅 파일을 만들고 editor-ui/public/index.html 파일에 스크립트 태그를 추가하는 것입니다:

<script src="frontend-hooks.js"></script>

프론트엔드 훅 파일#

프론트엔드 외부 훅 파일은 다음 형식을 가진 일반 JavaScript 파일입니다:

window.n8nExternalHooks = {
  nodeView: {
    mount: [
      function (store, meta) {
        // 무언가 수행
      },
    ],
    createNodeActiveChanged: [
      function (store, meta) {
        // 무언가 수행
      },
      function (store, meta) {
        // 다른 작업 수행
      },
    ],
    addNodeButton: [
      function (store, meta) {
        // 무언가 수행
      },
    ],
  },
};

프론트엔드 훅 함수#

훅당 여러 훅 함수를 정의할 수 있습니다. 각 훅 함수는 다음 인수로 호출됩니다:

• store: Vuex 스토어 객체. 스토어에서 데이터를 변경하거나 가져오는 데 사용할 수 있습니다.
• metadata: 훅에서 제공하는 데이터가 포함된 객체. 전달되는 내용을 보려면 editor-ui 패키지에서 훅을 검색하세요.