Backstage

​

Điều kiện tiên quyết

• Một instance Backstage mà CloudThinker truy cập được qua https. Với instance nằm sau firewall, xem Truy cập dịch vụ nội bộ.
• Quyền truy cập cấu hình ứng dụng Backstage và quyền khởi động lại Backstage.
• Vai trò Admin trong workspace CloudThinker, cần thiết để thêm kết nối. Xem Vai trò.

​

Thiết lập

node -p 'require("crypto").randomBytes(24).toString("base64")'

backend:
  auth:
    externalAccess:
      - type: static
        options:
          token: ${CLOUDTHINKER_TOKEN}
          subject: cloudthinker
        accessRestrictions:
          - plugin: catalog

curl -H "Authorization: Bearer $CLOUDTHINKER_TOKEN" \
  "https://backstage.example.com/api/catalog/entities/by-query?limit=1"

​

Chi tiết kết nối

​

Quyền yêu cầu

​

Khả năng của agent

​

Xác minh kết nối

Summarize our Backstage catalog: which kinds of entities it has and who owns them

​

Ví dụ prompt

Which components in Backstage have no owner set?
What are the owner, system, and dependencies of the payments-api component?
Which Backstage entries are missing a documentation link, and which should we fix first?

​

Thay đổi location

• Target mới phải là URL https nằm dưới tiền tố đã phê duyệt. Mọi thứ khác bị từ chối trước khi gửi yêu cầu.
• Cập nhật hoặc xóa location sẽ đọc target hiện tại trước và kiểm tra target đó nằm dưới cùng tiền tố, nên một phê duyệt không thể chạm vào location của nhóm khác.

​

Khắc phục sự cố

​

Bảo mật

• Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
• Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
• Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
• Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.

• Giới hạn token trong catalog: một dòng plugin: catalog ngăn token truy cập mọi plugin khác bạn đang chạy.
• Xoay vòng bằng cách thay mục cấu hình: static token không bao giờ tự hết hạn. Thay token trong cấu hình Backstage và khởi động lại. Mỗi workspace có một kết nối Backstage, nên không có biểu tượng bút chì để sửa. Mở More → Workspace settings → Connections, chọn Backstage, nhấn Disconnect, rồi kết nối lại với Service token mới. Quá trình discovery chạy lại và Allow writes trở về trạng thái bật. Xem Xoay vòng thông tin xác thực.

​

Liên quan