AccessEntity নীতি

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য

কি

Apigee Edge ডেটা স্টোর থেকে আপনার নির্দিষ্ট করা সত্তা প্রোফাইলগুলি পুনরুদ্ধার করে৷ নীতিটি প্রোফাইলটিকে একটি ভেরিয়েবলে রাখে যার নাম AccessEntity.{policy_name} । আপনি নিম্নলিখিত সত্তার প্রোফাইল অ্যাক্সেস করতে AccessEntity ব্যবহার করতে পারেন:

• অ্যাপ
• API পণ্য
• কোম্পানি
• কোম্পানির বিকাশকারী
• ভোক্তা কী
• বিকাশকারী

AccessEntity নীতি নীতি-ভিত্তিক রানটাইম ডাটাবেস লুকআপ হিসাবে কাজ করে। আপনি এই নীতি দ্বারা প্রত্যাবর্তিত প্রোফাইল তথ্য ব্যবহার করতে পারেন গতিশীল আচরণ সক্ষম করতে, যেমন শর্তসাপেক্ষ এন্ডপয়েন্ট রাউটিং, ফ্লো এক্সিকিউশন, নীতি প্রয়োগ।

আপনি এক্সএমএল হিসাবে সত্তা প্রোফাইল ডেটা পেতে AccessEntity নীতি ব্যবহার করেন এবং এটি একটি পরিবর্তনশীল মধ্যে রাখুন। আপনি একটি সত্তার ধরন এবং এক বা একাধিক শনাক্তকারী নির্দিষ্ট করে যা আপনি চান সেই ধরনের সত্তা নির্দিষ্ট করে পেতে সত্তাকে শনাক্ত করেন। পরে, অন্য নীতিতে, আপনি অন্য নীতির মাধ্যমে সত্তা প্রোফাইল ডেটা পুনরুদ্ধার করতে পারেন, যেমন একটি ExtractVariables নীতি বা AssignMessage নীতি ।

নমুনা

নিম্নলিখিত নমুনাগুলি ExtractVariables এবং AssignMessage নীতিগুলির সাথে একত্রে ব্যবহার করা AccessEntity দেখায় যা একজন বিকাশকারীর ইমেল এক্সট্র্যাক্ট করতে এবং এটি HTTP হেডারে যুক্ত করতে।

<AccessEntity name="GetDeveloperProfile">
  <!-- This is the type entity whose profile we need to pull from the Edge datastore. -->
  <EntityType  value="developer"/>
  <!-- We tell the policy to use the API key (presented as query parameter) to identify the developer. -->
  <EntityIdentifier ref="request.queryparam.apikey" type="consumerkey"/> 
</AccessEntity>

<ExtractVariables name="SetDeveloperProfile">
  <!-- The source element points to the variable populated by AccessEntity policy. 
  The format is <policy-type>.<policy-name>.
  In this case, the variable contains the whole developer profile. -->
  <Source>AccessEntity.GetDeveloperProfile</Source> 
  <VariablePrefix>developer</VariablePrefix>
  <XMLPayload>
    <Variable name="email" type="string"> 
        <!-- You parse elements from the developer profile using XPath. -->
      <XPath>/Developer/Email</XPath>
    </Variable>
  </XMLPayload>
</ExtractVariables>

<!-- We'll use this policy to return the variables set in the developer profile, 
just so that we can easily see them in the response. -->
<AssignMessage name="EchoVariables">
  <AssignTo createNew="false" type="response"></AssignTo>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <Set>
    <Headers>
      <Header name="X-Developer-email">{developer.email}</Header>
    </Headers>
  </Set>
</AssignMessage>

উপাদান রেফারেন্স

একটি AccessEntity নীতির কাঠামোর মূল হল:

<AccessEntity name="policy_name">
  <EntityType  value="entity_type"/>
  <EntityIdentifier ref="entity_identifier" type="identifier_type"/> 
  <SecondaryIdentifier ref="secondary_identifier" type="identifier_type"/>
</AccessEntity>

আপনি একটি Identifiers উপাদানে গোষ্ঠীবদ্ধ করে একই ধরণের একাধিক সত্তা অ্যাক্সেস করতে পারেন:

<AccessEntity name="name_of_the_policy">
  <EntityType  value="type_of_entity"/>
  <Identifiers>
    <Identifier>
      <EntityIdentifier ref="reference_to_entity_identifier" type*="identifier_type"/> 
      <SecondaryIdentifier ref="reference_to_secondary_entity_identifier" type="identifier_type"/><!-- optional -->
    </Identifier >
    <Identifier>
      <EntityIdentifier ref="reference_to_entity_identifier" type*="identifier_type"/> 
      <SecondaryIdentifier ref="reference_to_secondary_entity_identifier" type="identifier_type"/><!-- optional -->
    </Identifier >
  </Identifiers>
</AccessEntity>

<AccessEntity> বৈশিষ্ট্য

<AccessEntity async="false" continueOnError="false" enabled="true" name="policy_name">

নিম্নলিখিত সারণী সমস্ত নীতির মূল উপাদানগুলির জন্য সাধারণ বৈশিষ্ট্যগুলি বর্ণনা করে:

<DisplayName> উপাদান

ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে name বৈশিষ্ট্য ছাড়াও ব্যবহার করুন।

<DisplayName>Policy Display Name</DisplayName>

<EntityIdentifier> উপাদান

নির্দিষ্ট সত্তা নির্দিষ্ট করে -- EntityType-এ দেওয়া প্রকারের -- পেতে।

<EntityIdentifier ref="value_variable" type="identifier_type"/> 

গুণাবলী

উদাহরণ

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessEntity async="false" continueOnError="false" enabled="true" name="GetCompany">
    <DisplayName>GetCompanyProfile</DisplayName>
    <EntityType value="company"></EntityType>
    <EntityIdentifier ref="request.queryparam.apikey" type="consumerkey"/>
</AccessEntity>

<এন্টিটি টাইপ> উপাদান

ডেটা স্টোর থেকে পুনরুদ্ধার করার জন্য সত্তার ধরন নির্দিষ্ট করে।

<EntityType  value="entity_type"/>

প্রদত্ত ধরনের কোন সত্তা আপনি চান তা নির্দিষ্ট করতে একটি EntityIdentifier উপাদান ব্যবহার করুন। সত্তা প্রকারের একটি রেফারেন্সের জন্য, সত্তার ধরন এবং শনাক্তকারীগুলি দেখুন।

গুণাবলী

<সেকেন্ডারি আইডেন্টিফায়ার> উপাদান

EntityIdentifier এর সাথে একত্রে, প্রদত্ত EntityType পছন্দসই উদাহরণ সনাক্ত করার জন্য একটি মান নির্দিষ্ট করে।

<SecondaryIdentifier ref="value_variable" type="identifier_type"/>

SecondaryIdentifier ব্যবহার করুন যখন শুধুমাত্র একটি EntityIdentifier উল্লেখ করলে আপনি একটি একক সত্তা পাওয়ার নিশ্চয়তা দেবেন না। আরও তথ্যের জন্য সেকেন্ডারি আইডেন্টিফায়ার সহ সংকীর্ণ ফলাফল দেখুন।

একাধিক SecondaryIdentifier উপাদান ব্যবহার করা সমর্থিত নয়।

গুণাবলী

উদাহরণ

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessEntity async="false" continueOnError="false" enabled="true" name="GetAPIProduct">
    <DisplayName>GetAPIProduct</DisplayName>
    <EntityType value="apiproduct"></EntityType>
    <EntityIdentifier ref="developer.app.name" type="appname"/> 
    <SecondaryIdentifier ref="developer.id" type="developerid"/> 
</AccessEntity>

ব্যবহারের নোট

সেকেন্ডারি আইডেন্টিফায়ার সহ ফলাফল সংকুচিত করা

কিছু সত্তার জন্য, একটি শনাক্তকারী প্রদান করা আপনার পছন্দের সত্তা পাওয়ার জন্য যথেষ্ট নির্দিষ্ট নাও হতে পারে। এই ক্ষেত্রে, আপনি ফলাফল সংকুচিত করতে একটি গৌণ শনাক্তকারী ব্যবহার করতে পারেন।

আপনার প্রথম, সম্ভবত বিস্তৃত নীতি কনফিগারেশন এর মত দেখতে হতে পারে:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessEntity async="false" continueOnError="false" enabled="true" name="GetApp">
    <DisplayName>GetAppProfile</DisplayName>
    <EntityType value="apiproduct"></EntityType>
    <EntityIdentifier ref="request.queryparam.apikey" type="consumerkey"/>
</AccessEntity>

যেহেতু একটি অ্যাপ একাধিক API পণ্যের সাথে যুক্ত হতে পারে, শুধুমাত্র অ্যাপ আইডি ব্যবহার করে আপনার পছন্দের API পণ্যটি নাও হতে পারে (আপনি একাধিক মিলে যাওয়া পণ্যগুলির মধ্যে প্রথমটি পেতে পারেন)।

পরিবর্তে, আরও সঠিক ফলাফল পেতে, আপনি একটি SecondaryIdentifier ব্যবহার করতে পারেন। উদাহরণস্বরূপ, আপনার প্রবাহে appname এবং developerid ভেরিয়েবল থাকতে পারে কারণ এগুলি OAuth 2.0 এক্সচেঞ্জের সময় ডিফল্টরূপে পপুলেট করা হয়। অনুরোধ করা অ্যাপে প্রোফাইলের বিশদ বিবরণ পেতে আপনি AccessEntity নীতিতে সেই ভেরিয়েবলের মান ব্যবহার করতে পারেন।

আপনার আরো নির্দিষ্ট নীতি কনফিগারেশন এই মত দেখতে হতে পারে:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessEntity async="false" continueOnError="false" enabled="true" name="GetApp">
    <DisplayName>GetAppProfile</DisplayName>
    <EntityType value="apiproduct"></EntityType>
    <EntityIdentifier ref="developer.app.name" type="appname"/> 
    <SecondaryIdentifier ref="developer.id" type="developerid"/> 
</AccessEntity>

সমর্থিত সত্তা প্রকার এবং শনাক্তকারী

AccessEntity নিম্নলিখিত সত্তা প্রকার এবং শনাক্তকারী সমর্থন করে।

উদাহরণ সত্তা প্রোফাইল XML

XPath এর মাধ্যমে আপনি যে সত্তা প্রোফাইল মান চান তা পুনরুদ্ধার করতে, আপনাকে প্রোফাইল XML এর গঠন সম্পর্কে কিছু জানতে হবে। কাঠামোর একটি উদাহরণের জন্য, আপনি যে সত্তা চান তার জন্য XML পেতে একটি ব্যবস্থাপনা API কল ব্যবহার করুন। বিস্তারিত জানার জন্য, ব্যবস্থাপনা API রেফারেন্স পড়ুন।

নিম্নলিখিত বিভাগগুলিতে API কলগুলির জন্য কোড রয়েছে, কল থেকে XML উদাহরণ সহ।

অ্যাপস

$ curl -H "Accept:text/xml" -X GET \
https://api.enterprise.apigee.com/v1/o/{org_name}/apps/{app_id} \
-u email:password

এজ ম্যানেজমেন্ট এপিআই রেফারেন্সে অ্যাপ আইডি দ্বারা একটি সংস্থায় অ্যাপ পান দেখুন।

বা:

$ curl -H "Accept:text/xml" -X GET \
https://api.enterprise.apigee.com/v1/o/{org_name}/developers/{developer_email}/apps/{app_name} \
-u email:password

এজ ম্যানেজমেন্ট এপিআই রেফারেন্সে ডেভেলপার অ্যাপের বিবরণ পান দেখুন।

নমুনা প্রোফাইল:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<App name="thomas-app">
    <AccessType>read</AccessType>
    <ApiProducts/>
    <Credentials>
        <Credential>
            <Attributes/>
            <ConsumerKey>wrqOOOiPArFI0WRoB1gAJMRbOguekJ5w</ConsumerKey>
            <ConsumerSecret>WvOhDrJ8m6kzz7Ni</ConsumerSecret>
            <ApiProducts>
                <ApiProduct>
                    <Name>FreeProduct</Name>
                    <Status>approved</Status>
                </ApiProduct>
            </ApiProducts>
            <Scopes/>
            <Status>approved</Status>
        </Credential>
    </Credentials>
    <AppFamily>default</AppFamily>
    <AppId>ab308c13-bc99-4c50-8434-0e0ed1b86075</AppId>
    <Attributes>
        <Attribute>
            <Name>DisplayName</Name>
            <Value>Tom's Weather App</Value>
        </Attribute>
    </Attributes>
    <CallbackUrl>http://tom.app/login</CallbackUrl>
    <CreatedAt>1362502872727</CreatedAt>
    <CreatedBy>admin@apigee.com</CreatedBy>
    <DeveloperId>PFK8IwOeAOW01JKA</DeveloperId>
    <LastModifiedAt>1362502872727</LastModifiedAt>
    <LastModifiedBy>admin@apigee.com</LastModifiedBy>
    <Scopes/>
    <Status>approved</Status>
</App>

API পণ্য

$ curl  -H "Accept:text/xml" -X GET \
https://api.enterprise.apigee.com/v1/o/{org_name}/apiproducts/{apiproduct_name} \
-u email:password

এজ ম্যানেজমেন্ট এপিআই রেফারেন্সে এপিআই পণ্য পান দেখুন।

এক্সপাথের নমুনা, weather_free নামক API পণ্য থেকে দ্বিতীয় API সংস্থান (URI) পুনরুদ্ধার করে :

/ApiProduct['@name=weather_free']/ApiResources/ApiResource[1]/text()

নমুনা প্রোফাইল XML হিসাবে ফিরে এসেছে:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ApiProduct name="weather_free">
    <ApiResources>
        <ApiResource>/forecastrss, /reports</ApiResource>
    </ApiResources>
    <ApprovalType>auto</ApprovalType>
    <Attributes>
        <Attribute>
            <Name>description</Name>
            <Value>Introductory API Product</Value>
        </Attribute>
        <Attribute>
            <Name>developer.quota.interval</Name>
            <Value>1</Value>
        </Attribute>
        <Attribute>
            <Name>developer.quota.limit</Name>
            <Value>1</Value>
        </Attribute>
        <Attribute>
            <Name>developer.quota.timeunit</Name>
            <Value>minute</Value>
        </Attribute>
        <Attribute>
            <Name>servicePlan</Name>
            <Value>Introductory</Value>
        </Attribute>
    </Attributes>
    <CreatedAt>1355847839224</CreatedAt>
    <CreatedBy>andrew@apigee.com</CreatedBy>
    <Description>Free API Product</Description>
    <DisplayName>Free API Product</DisplayName>
    <Environments/>
    <LastModifiedAt>1355847839224</LastModifiedAt>
    <LastModifiedBy>andrew@apigee.com</LastModifiedBy>
    <Proxies/>
    <Scopes/>
</ApiProduct>

কোম্পানি

$ curl   -H "Accept:text/xml" -X GET \
https://api.enterprise.apigee.com/v1/o/{org_name}/companies/{company_name} \
-u email:password

এজ ম্যানেজমেন্ট এপিআই রেফারেন্সে কোম্পানির বিবরণ পান দেখুন।

নমুনা প্রোফাইল:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Company name="theramin">
    <Apps/>
    <DisplayName>Theramin Corporation</DisplayName>
    <Organization>apigee-pm</Organization>
    <Status>active</Status>
    <Attributes>
        <Attribute>
            <Name>billing_code</Name>
            <Value>13648765</Value>
        </Attribute>
    </Attributes>
    <CreatedAt>1349208631291</CreatedAt>
    <CreatedBy>andrew@apigee.com</CreatedBy>
    <LastModifiedAt>1349208631291</LastModifiedAt>
    <LastModifiedBy>andrew@apigee.com</LastModifiedBy>
</Company>

কোম্পানির বিকাশকারী

$ curl -H "Accept:text/xml" -X GET \
https://api.enterprise.apigee.com/v1/o/{org_name}/companies/{company_name}/developers/{developer_name} \
-u email:password

নমুনা প্রোফাইল:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Developers>
    <Developer>
        <Email>ntesla@theramin.com</Email>
        <Role>developer</Role>
    </Developer>
</Developers>

ভোক্তা কী

$ curl -H "Accept:text/xml" -X GET \
https://api.enterprise.apigee.com/v1/o/{org_name}/developers/{developer_email}/apps/{app_name}/keys/{consumer_key} \
-u email:password

এজ ম্যানেজমেন্ট এপিআই রেফারেন্সে একটি বিকাশকারী অ্যাপের মূল বিবরণ পান দেখুন।

নমুনা XPath:

/Credential/ApiProducts/ApiProduct[Name='weather_free']/Status/text()

নমুনা প্রোফাইল:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Credential>
    <Attributes/>
    <ConsumerKey>XLotL3PRxNkUGXhGAFDPOr6fqtvAhuZe</ConsumerKey>
    <ConsumerSecret>iNUyEaOOh96KR3YL</ConsumerSecret>
    <ApiProducts>
        <ApiProduct>
            <Name>weather_free</Name>
            <Status>approved</Status>
        </ApiProduct>
    </ApiProducts>
    <Scopes/>
    <Status>approved</Status>
</Credential>

বিকাশকারী

$ curl -H "Accept:text/xml" -X GET \
https://api.enterprise.apigee.com/v1/o/{org_name}/developers/{developer_email} \
-u email:password

এজ ম্যানেজমেন্ট এপিআই রেফারেন্সে ডেভেলপার পান দেখুন।

নমুনা XPath:

/Developer/Attributes/Attribute[Name='my_custom_attribute']/Value/text()

/Developer/Email/text()

নমুনা প্রোফাইল:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Developer>
    <Apps>
        <App>weatherappx</App>
        <App>weatherapp</App>
    </Apps>
    <Email>ntesla@theramin.com</Email>
    <DeveloperId>4Y4xd0KRZ1wmHJqu</DeveloperId>
    <FirstName>Nikola</FirstName>
    <LastName>Tesla</LastName>
    <UserName>theramin</UserName>
    <OrganizationName>apigee-pm</OrganizationName>
    <Status>active</Status>
    <Attributes>
        <Attribute>
            <Name>project_type</Name>
            <Value>public</Value>
        </Attribute>
    </Attributes>
    <CreatedAt>1349797040634</CreatedAt>
    <CreatedBy>rsaha@apigee.com</CreatedBy>
    <LastModifiedAt>1349797040634</LastModifiedAt>
    <LastModifiedBy>rsaha@apigee.com</LastModifiedBy>
</Developer>

ফ্লো ভেরিয়েবল

যখন AccessEntity নীতিতে নির্দিষ্ট করা সত্তা প্রোফাইল পুনরুদ্ধার করা হয়, তখন XML- ফরম্যাট করা প্রোফাইল অবজেক্ট একটি পরিবর্তনশীল হিসাবে বার্তা প্রসঙ্গে যোগ করা হয়। এটি পরিবর্তনশীল নামের রেফারেন্স সহ অন্য যে কোনো ভেরিয়েবলের মতো অ্যাক্সেস করা যেতে পারে। AccessEntity নীতির ব্যবহারকারীর দেওয়া নাম পরিবর্তনশীল নামের পরিবর্তনশীল উপসর্গ হিসেবে সেট করা হয়েছে।

উদাহরণস্বরূপ, যদি GetDeveloper নামের একটি AccessEntity নীতি কার্যকর করা হয়, তাহলে XML- ফরম্যাট করা প্রোফাইল AccessEntity.GetDeveloper নামের ভেরিয়েবলে সংরক্ষণ করা হয়। এক্সএমএল-ফরম্যাট করা প্রোফাইলটিকে তারপরে এক্সট্রাক্ট ভেরিয়েবল নীতিতে সংজ্ঞায়িত একটি XPath ব্যবহার করে পার্স করা যেতে পারে যা AccessEntity.GetDeveloper এর উত্স হিসাবে নির্দিষ্ট করে৷

ত্রুটি উল্লেখ

সম্পর্কিত তথ্যের জন্য, নীতি ত্রুটি এবং হ্যান্ডলিং ফল্ট সম্পর্কে আপনার কী জানা দরকার তা দেখুন৷

রানটাইম ত্রুটি

কোনোটিই নয়।

স্থাপনার ত্রুটি

সম্পর্কিত বিষয়

• ExtractVariables : ExtractVariables নীতি
• AssignMessage : AssignMessage নীতি