API Management etki alanları arası ilkeler

Bu konu, aşağıdaki ilkeler için bir API Management sağlar. İlke ekleme ve yapılandırma hakkında bilgi için bkz. API Management.

Etki alanı arası ilkeler

• Etki alanı arası çağrılara izin ver - API'yi Adobe Flash ve Microsoft Silverlight tarayıcı tabanlı istemcilerden erişilebilir hale gelir.
• CORS - Tarayıcı tabanlı istemcilerden etki alanı arası çağrılara izin vermek için bir işlem veya API'ye çıkış noktası arası kaynak paylaşımı (CORS) desteği ekler.
• JSONP - JavaScript tarayıcı tabanlı istemcilerden etki alanı arası çağrılara izin vermek için bir işlem veya API'ye doldurma (JSONP) desteğiyle JSON ekler.

Etki alanı arası çağrılara izin ver

cross-domainİlkeyi kullanarak API'yi Adobe Flash ve Microsoft Silverlight tarayıcı tabanlı istemcilerden erişilebilir hale gelir.

İlke deyimi

<cross-domain>
    <!-Policy configuration is in the Adobe cross-domain policy file format,
        see https://www.adobe.com/devnet-docs/acrobatetk/tools/AppSec/CrossDomain_PolicyFile_Specification.pdf-->
</cross-domain>

Örnek

<cross-domain>
        <allow-http-request-headers-from domain='*' headers='*' />
</cross-domain>

Öğeler

Kullanım

Bu ilke aşağıdaki ilke bölümlerinde ve kapsamlarında kullanılabilir.

• İlke bölümleri: gelen
• İlke kapsamları: tüm kapsamlar

CORS

İlke, tarayıcı tabanlı istemcilerden etki alanı arası çağrılara izin vermek için bir işlem veya API'ye çıkış noktası arası cors kaynak paylaşımı (CORS) desteği ekler.

CORS, bir tarayıcının ve sunucunun etkileşim kurmasına ve belirli çıkış noktası arası isteklere (bir web sayfasındaki JavaScript'den diğer etki alanlarına yapılan XMLHttpRequests çağrıları) izin verip vermeyişini belirlemesine olanak sağlar. Bu, yalnızca aynı çıkış noktası isteklerine izin verme esnekliği sağlar, ancak tüm çıkış noktası isteklerine izin vermeden daha güvenlidir.

Geliştirici portalında etkileşimli konsolu etkinleştirmek için CORS ilkesi uygulamanız gerekir. Ayrıntılar için geliştirici portalı belgelerine bakın.

İlke deyimi

<cors allow-credentials="false|true" terminate-unmatched-request="true|false">
    <allowed-origins>
        <origin>origin uri</origin>
    </allowed-origins>
    <allowed-methods preflight-result-max-age="number of seconds">
        <method>http verb</method>
    </allowed-methods>
    <allowed-headers>
        <header>header name</header>
    </allowed-headers>
    <expose-headers>
        <header>header name</header>
    </expose-headers>
</cors>

Örnek

Bu örnekte, özel üst bilgileri veya GET vePOST dışında yöntemlere sahip olanlar gibi, uçuş öncesi isteklerin nasıl desteklenleri gösterir. Özel üst bilgileri ve ek HTTP fiillerini desteklemek için, aşağıdaki allowed-methods örnekte gösterildiği gibi ve bölümlerini allowed-headers kullanın.

<cors allow-credentials="true">
    <allowed-origins>
        <!-- Localhost useful for development -->
        <origin>http://localhost:8080/</origin>
        <origin>http://example.com/</origin>
    </allowed-origins>
    <allowed-methods preflight-result-max-age="300">
        <method>GET</method>
        <method>POST</method>
        <method>PATCH</method>
        <method>DELETE</method>
    </allowed-methods>
    <allowed-headers>
        <!-- Examples below show Azure Mobile Services headers -->
        <header>x-zumo-installation-id</header>
        <header>x-zumo-application</header>
        <header>x-zumo-version</header>
        <header>x-zumo-auth</header>
        <header>content-type</header>
        <header>accept</header>
    </allowed-headers>
    <expose-headers>
        <!-- Examples below show Azure Mobile Services headers -->
        <header>x-zumo-installation-id</header>
        <header>x-zumo-application</header>
    </expose-headers>
</cors>

Öğeler

Öznitelikler

Kullanım

Bu ilke aşağıdaki ilke bölümlerinde ve kapsamlarında kullanılabilir.

• İlke bölümleri: gelen
• İlke kapsamları: tüm kapsamlar

JSONP

İlke, JavaScript tarayıcı tabanlı istemcilerden etki alanı arası çağrılara izin vermek için bir işlem veya API'ye doldurma jsonp (JSONP) desteğiyle JSON ekler. JSONP, Farklı bir etki alanındaki bir sunucudan veri isteğinde etmek için JavaScript programlarında kullanılan bir yöntemdir. JSONP, web sayfalarına erişimin aynı etki alanında olması gereken çoğu web tarayıcısı tarafından zorlanan sınırlamayı atlar.

İlke deyimi

<jsonp callback-parameter-name="callback function name" />

Örnek

<jsonp callback-parameter-name="cb" />

?cb=XXX geri çağırma parametresi olmadan yöntemini çağırsanız düz JSON (işlev çağrısı sarmalayıcı olmadan) döner.

Geri çağırma parametresini eklersanız bir JSONP sonucu döner ve özgün JSON sonuçlarını gibi geri ?cb=XXX çağırma işlevinin çevresinde sarmalar XYZ('<json result goes here>');

Öğeler

Öznitelikler

Kullanım

Bu ilke aşağıdaki ilke bölümlerinde ve kapsamlarında kullanılabilir.

• İlke bölümleri: giden
• İlke kapsamları: tüm kapsamlar

Sonraki adımlar

İlkelerle çalışma hakkında daha fazla bilgi için bkz:

• API Management'de ilkeler
• API'leri dönüştürme
• İlke deyimlerinin ve ayarlarının tam listesi için İlke Başvurusu
• İlke örnekleri