İçeriğe geç
App Store

Gömülü Uygulamalar

Gömülü olarak tanımlanan uygulamalar, mağaza panelindeki uygulama sayfasında bir çerçeve (iframe) içinde açılır. Panel bu durumda yetkilendirme adresine değil, doğrudan Redirect URL'nize imzalı parametrelerle gider; uygulamanız mağazayı doğruladıktan sonra gerekirse kendi yetkilendirme isteğini başlatır.

  1. 1.Mağaza yöneticisi→Mağaza paneli

    Uygulamalar sayfasında uygulama detayını açar

  2. 2.Mağaza paneli→Uygulamanız

    Uygulamanızı çerçeve içinde açar

    Redirect URL'nize embedded, domain, date, varsa renew_date ve hmac parametreleriyle.

  3. 3.Uygulamanız

    hmac ve date değerini doğrular

    date bugün veya dün değilse adresi reddedin.

  4. 4.Uygulamanız→Mağaza paneli

    Oturum yoksa yetkilendirme ister

    /panel/auth adresine kendi ürettiğiniz state ile.

  5. 5.Mağaza paneli→Uygulamanız

    code ile geri döner

    Uygulama kurulu olduğu için izin ekranı gösterilmez.

  6. 6.Uygulamanız→Mağaza API

    Yetki kodunu token ile değiştirir

    POST /oauth/v2/token

  7. 7.Uygulamanız→Mağaza yöneticisi

    Arayüzünü panel içinde gösterir

Açılış adresi

Code
GET https://uygulamaniz.example.com/ideasoft/callback ?embedded=1 &domain=magaza-adiniz.myideasoft.com &date=20260518 &renew_date=20270401 &hmac=8b4ac8621d8df8ee80a7af7a62c29671aae737a5e1ef1e199765126f3243ccff
ParametreAçıklama
embeddedHer zaman 1.
domainMağazanın alan adı, şema olmadan (ör. magaza-adiniz.myideasoft.com).
dateAdresin üretildiği gün, YYYYMMDD (Türkiye saati).
renew_dateYalnızca yıllık yenilemeli ürünlerde: yenileme tarihi, YYYYMMDD.
hmacYukarıdaki parametrelerin HMAC-SHA256 imzası.

Redirect URL sorgu dizesi içermemeli

Panel bu parametreleri Redirect URL'nizin sonuna ? ile ekler. Kayıtlı adresiniz zaten ? içeriyorsa açılış adresi bozulur.

hmac doğrulama

Code
hmac = hex( HMAC-SHA256( JSON, client_secret ) ) JSON (renew_date yoksa): {"embedded":"1","domain":"<domain>","date":"<date>"} JSON (renew_date varsa): {"embedded":"1","domain":"<domain>","date":"<date>","renew_date":"<renew_date>"}
  • Metin, state doğrulamadaki gibi PHP json_encode çıktısıdır: anahtar sırası sabit, boşluk yok.
  • embedded değeri sayı değil, "1" metnidir.
  • date URL'de gelir; imzayı bu değerle hesaplayın, ardından tarihin bugün veya dün olduğunu kontrol edin. Daha eski adresleri reddedin.
  • Karşılaştırmayı sabit zamanlı yapın.
<?php function verifyEmbedded(array $query, string $clientSecret): bool { $data = [ 'embedded' => (string)($query['embedded'] ?? ''), 'domain' => $query['domain'] ?? '', 'date' => $query['date'] ?? '', ]; if (!empty($query['renew_date'])) { $data['renew_date'] = $query['renew_date']; } $expected = hash_hmac('sha256', json_encode($data), $clientSecret); if (!hash_equals($expected, (string)($query['hmac'] ?? ''))) { return false; } $today = new DateTimeImmutable('now', new DateTimeZone('Europe/Istanbul')); $allowed = [$today->format('Ymd'), $today->modify('-1 day')->format('Ymd')]; return in_array($data['date'], $allowed, true); }

Test vektörü: client_secret=ornek-client-secret, domain=magaza-adiniz.myideasoft.com, date=20260518 (renew_date yok) için imzalanan metin {"embedded":"1","domain":"magaza-adiniz.myideasoft.com","date":"20260518"}, hmac değeri 8b4ac8621d8df8ee80a7af7a62c29671aae737a5e1ef1e199765126f3243ccff olur.

hmac oturum değildir

hmac yalnızca mağaza ve gün bilgisini imzalar; aynı gün içinde tekrar kullanılabilir. Bu yüzden onu kalıcı oturum veya API yetkisi olarak kullanmayın, log kayıtlarına yazmayın. Mağaza verisine erişmek için aşağıdaki yetkilendirmeyi tamamlayın.

Yetkilendirme

Bu mağaza için geçerli bir oturumunuz veya token'ınız yoksa, çerçeve içinden mağazanın yetkilendirme adresine kendi ürettiğiniz bir state ile yönlendirin:

Code
GET https://magaza-adiniz.myideasoft.com/panel/auth ?client_id=<client_id> &response_type=code &redirect_uri=<kayıtlı redirect_uri> &state=<sizin ürettiğiniz rastgele değer>

Uygulama mağazada zaten kurulu olduğu için onay ekranı gösterilmez; mağaza Redirect URL'nize state, code, domain ve user_id ile döner. Bu akışta state Ideasoft imzası değil, sizin gönderdiğiniz değerdir; sakladığınız değerle karşılaştırın. Ardından code ile token alın.

Çerçeve içinde çalışma

  • Uygulamanız mağaza panelinin içinde çerçevede açılır. Çerçevelenmeyi engelleyen başlıklar (X-Frame-Options, frame-ancestors içeren Content-Security-Policy) mağaza alan adlarının uygulamanızı göstermesine izin vermelidir.
  • Tarayıcılar çerçeve içindeki üçüncü taraf çerezleri kısıtlayabilir. Oturumunuzu yalnızca çereze bağlamayın; her açılışta hmac doğrulaması ve yetkilendirme akışıyla yeniden kurulabilecek şekilde tasarlayın.
Son güncelleme: