ApivomApivom
Demo Alın

Autodesk APS Secure Service Account Bağlayıcısı

Autodesk Platform Services'in Secure Service Account (SSA) API'si — servis hesabı kimliklerini ve imzalama anahtarlarını oluşturup yönetin, ardından imzalı bir iddiayı erişim jetonuyla değiştirin — Apivom Atlas'ta 10 rota olarak kayıtlı: sunucu tarafı APS entegrasyonları için etkileşimsiz kimlik katmanı.

Neler yapabilirsiniz

  • Servis hesapları: APS uygulamanız altında oluşturun, listeleyin, okuyun, güncelleyin ve silin
  • Servis hesabı başına anahtarlar: hesabın imzaladığı açık anahtarları oluşturun, listeleyin, döndürün (güncelleyin) ve silin
  • Jeton: bir servis hesabı anahtarıyla imzalanmış JWT iddiasını kapsamlı bir APS erişim jetonuyla değiştirin — kullanıcı girişi yok, istekte paylaşılan sır yok
  • developer.api.autodesk.com üzerinde 10 rota (3 salt okunur), yapay zekâ entegrasyon rehberinde (llms.txt) belgeli

Kullanım senaryoları

  • ACC projelerine gözetimsiz erişim — Bir servis hesabı oluşturun, gece senkronizasyonunun okuması gereken projelere davet edin ve işin kullanıcı oturumu olmadan kendi jetonlarını üretmesine izin verin.
  • Kesintisiz anahtar döndürme — Yeni bir anahtar kaydedin, imzalamayı ona geçirin, sonra eskisini silin — servis hesabı ve proje üyelikleri değişmez.

Secure Service Account, Autodesk Platform Services'in pratik bir sorununu çözer: Autodesk Construction Cloud ve Data Management verisinin çoğuna yalnızca üç taraflı jetonla ulaşılır ve bu normalde bir insanın oturum açmasını gerektirir. SSA, bir uygulamanın servis hesapları — kendi Autodesk kullanıcı kimliği olan makine kimlikleri — oluşturmasını sağlar; hesap yöneticisi bunları herhangi bir üye gibi ACC projelerine davet edebilir. Her servis hesabı bir veya daha fazla açık anahtar tutar; uygulama eşleşen özel anahtarla kısa ömürlü bir JWT iddiası imzalar ve istenen kapsamlarla erişim jetonu almak için jeton uç noktasına gönderir. Yönetim rotaları, application:service_account kapsamlı iki taraflı jetonlarla servis hesaplarını ve anahtarlarını oluşturur, okur, günceller ve siler. Apivom Atlas 10 rotanın tamamını, 3'ü salt okunur, APS kimlik bilgisi sözleşmesi ve yapay zekâ entegrasyon rehberiyle (llms.txt) kataloglar ve her çağrıyı kiracı bazında kaydeder; özel anahtarlar asla Atlas'tan geçmez. Bugün hiçbir Apivom ürün akışı APS kullanmaz; bağlayıcı, gözetimsiz her ACC senkronizasyonunun yapı taşıdır ve bir ürün akışı müşteri bazında kapsamlanır.

Kimlik doğrulama

Autodesk Platform Services uygulamanız (aps.autodesk.com'dan istemci kimliği + sırrı) ve bu API'nin gerektirdiği kapsamlar. Çağıran OAuth2 v2 jetonunu alır — uygulama verisi için iki taraflı, kullanıcı hub'ları için üç taraflı — ve Bearer olarak gönderir; Apivom Atlas iletir, kaydeder, saklamaz.

Sık sorulan sorular

Bu bağlayıcıyı bugün açabilir miyim?

Bağlayıcı Apivom Atlas'ta kayıtlıdır — tüm rotalar kataloglanmış, kimlik bilgisi sözleşmesi yayımlanmış ve yapay zekâ entegrasyon rehberi (llms.txt) yayındadır — ve kimlik bilginiz Apivom Iris'te saklanabilir. Bir ürün akışına bağlanması (senkronizasyon, otomasyon, bildirim) müşteri bazında yapılır: kullanım senaryonuzu iletin, kapsamı birlikte belirleyelim.

Bunun iki taraflı jetondan farkı ne?

İki taraflı jeton uygulamayı tanımlar ve yalnızca OSS kovaları gibi uygulamaya ait kaynaklara ulaşır. Servis hesabı jetonu, ACC veya BIM 360 projelerinin üyesi olabilen bir makine kullanıcısını tanımlar; böylece oturum açmış bir kullanıcının ulaşacağı hub, klasör ve sorunlara — oturum açmadan — ulaşır.

Özel anahtar nerede durur?

Çağıranda. Autodesk yalnızca açık anahtarı saklar; uygulama özel anahtarı tutar, iddiayı yerelde imzalar ve iddiayı jeton rotasına gönderir. Apivom Atlas bu çağrıyı iletir ve hiçbir şey saklamaz.

Apivom bu bağlayıcı için API çağrısı başına ücret alır mı?

Hayır. Bağlayıcılar Apivom kiracınızın parçasıdır ve Atlas portalında ölçümlenmez. Bağladığınız hesapta sağlayıcının kendi fiyatlandırması, kotaları ve hız sınırları geçerli olmaya devam eder — Apivom çağrılarını bu sınırların içinde kalacak şekilde hızlandırır ve her çağrıyı kiracınızın entegrasyon günlüğünde gösterir.

Kimlik bilgilerim nerede saklanır, trafiği kim görür?

Apivom Atlas durumsuz bir geçittir: sağlayıcı kimlik bilgilerini veya jetonları asla saklamaz. Bağlanan Apivom ürünü kimlik bilgisini kiracı veritabanınızda şifreli tutar; her istek ve yanıt yalnızca kiracınızda kaydedilir — verileriniz kiracılar arasında asla paylaşılmaz.

Diğer Atlas entegrasyonları

AI entegrasyon rehberi (llms.txt)

Makine tarafından okunabilir markdown — AI asistanınıza entegrasyon talimatı olarak verin.