Directory

Directory는 Letterflow에서 재사용할 지역 값을 저장합니다. 값, 자격 증명, 개인 키는 선택한 지역에서 암호화됩니다.

변수 만들기 및 참조

대시보드에서 Directory 변수를 만들고 편집하세요. 각 변수에는 전용 양식이 있으며 만들 때 지역을 선택합니다.

Directory에서 지역을 선택하고 이름이 있는 변수를 저장하세요. 이름은 영문자로 시작하며 영문자, 숫자, 밑줄로 최대 60자입니다. 지역 코드는 예약되어 있으며 이름은 계정과 지역 안에서 고유해야 합니다.

{{ dir.base_url }}
{{ dir.au.base_url }}
{{ dir["us"].base_url }}

설정 페이지에서 기본 지역을 설정하세요. 지역을 생략한 참조는 기본 지역을 사용합니다. 명시한 지역은 요금제에서 사용할 수 있어야 합니다. Tinkerer에서는 공유 헤더의 종속 항목을 포함한 모든 종속 항목이 Coordinator 지역에 있어야 합니다.

변수 유형

텍스트와 비밀 텍스트는 입력한 텍스트를 그대로 저장합니다. 비밀 텍스트 편집 필드는 값을 가려서 표시합니다.
JSON과 XML은 문서 텍스트를 받습니다. 전체 참조는 원문을 유지하며 속성과 인덱스 경로로 파싱된 문서를 탐색합니다. 구조화된 하위 값은 JSON으로 출력됩니다.
XML 경로에는 루트 요소가 포함됩니다. 반복되는 자식은 목록이 되고 속성은 @name, 혼합 텍스트는 #text를 사용합니다. 네임스페이스 키는 대괄호로 지정합니다. DTD, 엔티티, 외부 참조는 거부됩니다.
기본 인증은 ID와 비밀번호를 저장합니다. .id 또는 .password를 사용하거나 Directory 기본 인증 필드에서 전체 변수를 참조하세요. HTTP에는 Basic Authorization을 설정하고 FTP와 SFTP에는 두 필드를 전달합니다.
개인 키를 업로드하거나 Ed25519로 생성할 수 있으며 선택적으로 암호문을 저장할 수 있습니다. .key와 .passphrase를 사용하거나 Directory 개인 키(SFTP) 필드에서 전체 변수를 참조하세요. 생성된 공개 키를 서버에 복사하세요.
HTTP 헤더는 텍스트 또는 필드로 편집합니다. 헤더 값은 다른 Directory 변수를 참조할 수 있습니다. Letterflow 단계 참조와 순환 종속 관계는 거부됩니다.

JSON/XML 값의 표현식을 확장합니다. Directory 템플릿은 Directory 변수만 참조할 수 있습니다. 삽입된 값은 이스케이프되며 다시 해석되지 않습니다. 문서 템플릿

공유 헤더

Letter 구성 요소의 Directory 헤더 필드에 Headers 변수나 텍스트 값으로 구성된 JSON 객체를 사용하세요. 로컬 헤더는 대소문자를 구분하지 않고 공유 헤더를 덮어씁니다. 값 안에서 Directory 참조가 필요하면 Headers를 선택하세요. JSON 값은 그대로 사용됩니다.

{{ dir.common_headers }}
Authorization: Bearer {{ dir.api_token }}

캡처한 리비전 및 한도

제출 시 큐에 넣기 전에 기본 지역과 필요한 모든 변수의 불변 리비전을 캡처합니다. 이후 편집으로 입력이 바뀌지 않습니다. 예약 실행은 매번 최신 리비전을 캡처합니다. 필수 변수를 삭제하면 관련 대기 실행은 취소되고 승인된 실행은 스냅샷을 유지합니다.

Directory 한도는 모든 지역을 합하여 Tinkerer 5개, Aspiring 30개, Coder 100개입니다. 텍스트, 비밀 텍스트, JSON, XML 값의 크기는 각각 64 KiB, 256 KiB, 1 MiB까지입니다. 헤더는 64 KiB, 기본 인증 각 필드와 암호문은 4 KiB, 개인 키는 256 KiB까지입니다. 확장 후에도 요청과 메모리 실행 한도가 적용됩니다.

편집기는 업로드 전에 크기, JSON/XML 구문과 중첩, 헤더를 검사합니다. 오류가 발생해도 초안은 유지됩니다. 최종 검증은 서버에서 수행합니다. 헤더만 Directory 참조를 확장하며 텍스트, JSON, XML은 그대로 유지됩니다.

연동 접근

유료 연동 키는 directory:read를 명시적으로 선택하여 변수 목록과 지역 값 URL을 조회할 수 있습니다. 비밀 값도 포함하는 권한이며 자동으로 부여되지 않습니다. Directory 변경은 대시보드에서만 가능합니다.