Azure Logic Apps'teki bir iş akışından IBM MQ sunucusuna bağlanma

Şunlar için geçerlidir: Azure Logic Apps (Tüketim + Standart)

Bu kılavuz, MQ bağlayıcısını kullanarak Azure Logic Apps'teki bir iş akışından Azure'da barındırılan veya şirket içi MQ sunucusuna nasıl erişeceklerini gösterir. Ardından MQ sunucunuzda depolanan iletileri alan ve gönderen otomatik iş akışları oluşturabilirsiniz. Örneğin, iş akışınız kuyruktaki tek bir iletiye göz atabilir ve ardından başka eylemler çalıştırabilir.

MQ bağlayıcısı, TCP/IP ağı üzerinden uzak bir MQ sunucusuyla iletişim kurmak için tüm mesajlaşma özelliklerini içeren bir Microsoft MQ istemcisi etrafında bir sarmalayıcı sağlar. Bu bağlayıcı, MQ istemcisini çağırmak için bağlantıları, işlemleri ve parametreleri tanımlar.

Desteklenen IBM WebSphere MQ sürümleri

• MQ 7.5
• MQ 8.0
• MQ 9.0, 9.1, 9.2 ve 9.3

Bağlayıcı teknik başvurusu

MQ bağlayıcısı, mantıksal uygulama türüne ve konak ortamına göre farklı sürümlere sahiptir.

TLS (SSL) şifrelemesi ile kimlik doğrulaması

MQ yönetilen bağlayıcısını (Tüketim veya Standart iş akışları) veya MQ yerleşik bağlayıcısını (yalnızca Standart iş akışları) kullanıp kullanmadığınıza bağlı olarak, MQ bağlayıcısı aşağıdaki kimlik doğrulama yollarından birini veya her ikisini destekler:

Özel anahtar ve ortak anahtar sertifikaları hakkında notlar

• Doğrulama gerektiren sertifika her zaman özel anahtar sertifikasıdır. Doğrulamayı gerçekleştirmek için kullanılan sertifika her zaman bir ortak anahtar sertifikasıdır.

• Genel olarak güvenilen özel anahtar sertifikası, tanınan bir Sertifika Yetkilisi tarafından verilir. Genel olarak güvenilmeyen özel anahtar sertifikası otomatik olarak imzalanan, özel CA ve benzer sertifikalar içerir.

• MQ sunucunuzdan gönderilen özel anahtar sertifikasını doğrulamak için, MQ bağlayıcısı genellikle mantıksal uygulamanızın sanal makine konağından konağın Güvenilen Kök Sertifika Yetkilileri (CA) Deposu'nda bulunan ortak anahtar sertifikalarını kullanır.

  Ancak, ana bilgisayar gerekli tüm ortak anahtar sertifikalarına sahip değilse veya MQ sunucunuz genel olarak güvenilmeyen bir özel anahtar sertifikası gönderiyorsa, ek adımlar uygulamanız gerekir. Daha fazla bilgi için bkz. Önkoşullar.

• Bir istemcinin Standart mantıksal uygulamanızdan gönderilen özel anahtar sertifikasını doğrulamak için MQ sunucusu, MQ sunucunuzun sertifika deposunda bulunan ortak anahtar sertifikalarını kullanır. Mantıksal uygulamanızın istemci sertifikası olarak kullanması için özel anahtar sertifikası eklemek için bkz . Özel anahtar sertifikası ekleme.

Sınırlamalar

• TLS (SSL) şifrelemesi ile kimlik doğrulaması

  MQ bağlayıcısı	Desteklenen kimlik doğrulama yönü
  Yönetilen	Yalnızca sunucu (tek yönlü)
  Yerleşik	- Sunucu istemcisi (iki yönlü) - Yalnızca sunucu (tek yönlü)

• Sunucu sertifikası doğrulaması

  MQ yerleşik bağlayıcısı, sunucu sertifikasının son kullanma tarihini veya sertifika zincirini doğrulamaz.

• Karakter kümesi dönüştürmeleri

  • MQ yönetilen bağlayıcısı herhangi bir karakter kümesi dönüştürmesi yapmaz veya iletinin Biçim alanını kullanmaz. Bağlayıcı yalnızca ileti alanında görünen verileri kopyalar ve iletiyi birlikte gönderir.

  • MQ yerleşik bağlayıcısı, yalnızca veri biçimi bir dize olduğunda karakter kümesi dönüştürmeleri yapabilir. Farklı bir karakter kümesi kimliği (kod sayfası) sağlarsanız, bağlayıcı verileri yeni kod sayfasına dönüştürmeyi dener.

• MQ bağlayıcısı bölümlenmiş iletileri desteklemez.

Daha fazla bilgi için MQ yönetilen bağlayıcı başvurusu veya MQ yerleşik bağlayıcı başvurularını gözden geçirin.

Önkoşullar

• Bir Azure hesabı ve aboneliği Azure aboneliğiniz yoksa ücretsiz bir Azure hesabı için kaydolun.

• Şirket içi MQ sunucusuna bağlanmak için, şirket içi veri ağ geçidini ağınızdaki bir sunucuya yüklemeniz gerekir. MQ bağlayıcısının çalışması için, şirket içi veri ağ geçidine sahip sunucuda da .NET Framework 4.6 yüklü olmalıdır.

  Ağ geçidini yükledikten sonra Azure'da bir veri ağ geçidi kaynağı da oluşturmanız gerekir. MQ bağlayıcısı, MQ sunucunuza erişmek için bu kaynağı kullanır. Daha fazla bilgi için Bkz . Veri ağ geçidi bağlantısını ayarlama.

  Not

  Aşağıdaki senaryolarda ağ geçidine ihtiyacınız yoktur:

  • MQ sunucunuz genel kullanıma açıktır veya Azure'da kullanılabilir.
  • Yönetilen bağlayıcıyı değil MQ yerleşik bağlayıcısını kullanacaksınız.

• MQ sunucunuza erişmek istediğiniz mantıksal uygulama kaynağı ve iş akışı.

  • MQ yönetilen bağlayıcısını şirket içi veri ağ geçidiyle kullanmak için mantıksal uygulama kaynağınızın Azure'daki ağ geçidi kaynağınızla aynı konumu kullanması gerekir.

  • Herhangi bir tetikleyici sağlamayan MQ yönetilen bağlayıcısını kullanmak için iş akışınızın bir tetikleyiciyle başladığından veya önce iş akışınıza bir tetikleyici eklediğinizden emin olun. Örneğin, Yinelenme tetikleyicisini kullanabilirsiniz.

  • MQ yerleşik bağlayıcısından bir tetikleyici kullanmak için boş bir iş akışıyla başladığınızdan emin olun.

• TLS (SSL) şifrelemesi ile kimlik doğrulaması için sertifika gereksinimleri

  • MQ yönetilen bağlayıcısı

    MQ sunucusu	Gereksinimler
    Azure tarafından barındırılan MQ sunucusu	MQ sunucusunun, doğrulama için mantıksal uygulama istemcinize güvenilen bir sertifika yetkilisi tarafından verilen bir özel anahtar sertifikası göndermesi gerekir.
    Şirket içi veri ağ geçidini kullanan şirket içi MQ sunucusu	Otomatik olarak imzalanan veya özel CA sertifikası gibi genel olarak güvenilmeyen bir özel anahtar sertifikası göndermek için, sertifikayı şirket içi veri ağ geçidi yüklemesiyle yerel bilgisayardaki Güvenilen Kök Sertifika Yetkilileri (CA) Deposu'na eklemeniz gerekir. Bu görev için Windows Sertifika Yöneticisi'ni (certmgr.exe) kullanabilirsiniz.

  • MQ yerleşik bağlayıcısı

    Standart mantıksal uygulamalar, ana bilgisayar platformu olarak ve sertifikaları işlemek için Azure App Service kullanır. Herhangi bir WS* planındaki Standart mantıksal uygulamalar için yerel makine sertifika deposuna ortak, özel, özelleştirilen veya otomatik olarak imzalanan sertifikalar ekleyebilirsiniz. Ancak Standart mantık uygulamanızın çalıştığı sanal makine ana bilgisayarındaki Güvenilen Kök CA Deposuna sertifika eklemeniz gerekiyorsa, App Service, mantık uygulamanızın yalıtılmış olarak App Service Ortamı v3'te (ASE); yalnızca Windows ve ASE tabanlı bir App Service planı ile çalışmasını gerektirir. Daha fazla bilgi için bkz. Sertifikalar ve App Service Ortamı.

    • MQ sunucusu kimlik doğrulaması

      Aşağıdaki tabloda, senaryonuz temelinde sertifika önkoşulları açıklanmaktadır:

      Gelen MQ sunucusu sertifikası	Gereksinimler
      Güvenilen bir sertifika yetkilisi tarafından verilen ve genel olarak güvenilen özel anahtar sertifikası	Mantıksal uygulamanızın sanal makine ana bilgisayarı genellikle gelen MQ sunucusunun özel anahtar sertifikasını doğrulamak için gerekli ortak anahtar sertifikalarına sahip olduğundan çoğu zaman mantıksal uygulamanızın başka bir kuruluma ihtiyacı olmaz. Bu ortak anahtar sertifikalarının mevcut olup olmadığını denetlemek için Mevcut ortak anahtar sertifikalarının parmak izlerini görüntüleme ve onaylama adımları izleyin. Sanal makine konağı, gelen MQ sunucusunun özel anahtar sertifikasını ve zincirleme sertifikalarını doğrulamak için gerekli tüm ortak anahtar sertifikalarına sahip değilse aşağıdaki adımları tamamlayın: 1. Standart mantıksal uygulamanızı yalnızca Windows ve ASE tabanlı bir App Service planıyla Azure Uygulaması Hizmet Ortamı v3 (ASE) kullanarak yeniden oluşturun. 2. Gerekli ortak anahtar sertifikalarını konağın Güvenilen Kök CA Deposuna el ile ekleyin.
      Otomatik olarak imzalanan veya özel CA sertifikası gibi genel olarak güvenilmeyen özel anahtar sertifikası	Mantıksal uygulamanızın sanal makine konağı, MQ sunucusunun sertifika zincirini doğrulamak için konağın Güvenilen Kök CA Deposu'nda gerekli ortak anahtar sertifikalarına sahip olmayacaktır. Bu durumda aşağıdaki adımları tamamlayın: 1. Standart mantıksal uygulamanızı yalnızca Windows ve ASE tabanlı bir App Service planıyla Azure Uygulaması Hizmet Ortamı v3 (ASE) kullanarak yeniden oluşturun. 2. Gerekli ortak anahtar sertifikalarını konağın Güvenilen Kök CA Deposuna el ile ekleyin. Daha fazla bilgi için aşağıdaki belgelere bakın: - Sertifika bağlamaları ve App Service Ortamı - Azure App Service'te TLS/SSL sertifikaları ekleme ve yönetme

    • Mantıksal uygulama istemcisi kimlik doğrulaması

      İstemci sertifikası olarak göndermek üzere bir özel anahtar sertifikası ekleyebilir ve ardından MQ yerleşik bağlayıcısının bağlantı ayrıntılarında sertifikanın parmak izi değerini belirtebilirsiniz. Daha fazla bilgi için bkz. özel anahtar sertifikası ekleme.

    Öneri: MQ sunucusu 9.0 veya sonraki bir sürüme yükseltin. Ayrıca, MQ sunucunuzda sunucu bağlantısı kanalını istemci bağlantınız tarafından kullanılan şifreleme belirtimiyle eşleşen bir şifreleme paketiyle ayarladığınızdan emin olun: örneğin, ANY_TLS12_OR_HIGHER. Daha fazla bilgi için Şifre gereksinimleri ile ilgili bir sonraki öğeye bakın.

• Şifreleme belirtimi gereksinimleri

  MQ sunucusu, TLS (SSL) şifrelemesi kullanan bağlantılar için şifreleme belirtimini tanımlamanızı gerektirir. Bu şifreleme belirtimi, MQ sunucusunun çalıştığı işletim sistemi tarafından desteklenen, seçilen ve kullanılan şifreleme paketleriyle eşleşmelidir. Sonuç olarak, istemci bağlantısı tarafından kullanılan şifreleme belirtimi, MQ sunucusundaki sunucu bağlantısı kanalında ayarlanan şifreleme paketleriyle eşleşmelidir.

  Daha fazla bilgi için bkz. Bağlantı ve kimlik doğrulaması sorunları.

MQ tetikleyicisi ekleme (yalnızca Standart mantıksal uygulama)

Aşağıdaki adımlar yalnızca MQ yerleşik bağlayıcısı tarafından sağlanan tetikleyicileri kullanabilen Standart mantıksal uygulama iş akışları için geçerlidir. MQ yönetilen bağlayıcısı tetikleyici içermez.

Bu adımlar Azure portalını kullanır, ancak uygun Azure Logic Apps uzantısıyla Visual Studio Code'u kullanarak bir Standart mantıksal uygulama iş akışı oluşturabilirsiniz.

1. Azure portalında tasarımcıda boş mantıksal uygulama iş akışınızı açın.

2. İstediğiniz MQ yerleşik tetikleyicisini eklemek için bu genel adımları izleyin. Daha fazla bilgi için bkz . MQ yerleşik bağlayıcı tetikleyicileri.

3. Bağlantınızın kimliğini doğrulamak için gerekli bilgileri sağlayın. Bitirdiğinizde Oluştur'u seçin.

4. Tetikleyici bilgileri kutusu görüntülendiğinde, tetikleyiciniz için gerekli bilgileri sağlayın.

5. Tamamladığınızda, iş akışınızı kaydedin. Tasarımcı araç çubuğunda Kaydet'i seçin.

MQ eylemi ekleme

Tüketim mantıksal uygulaması iş akışı yalnızca MQ yönetilen bağlayıcısını kullanabilir. Ancak Standart mantıksal uygulama iş akışı MQ yönetilen bağlayıcısını ve MQ yerleşik bağlayıcısını kullanabilir. Her sürümün birden çok eylemi vardır. Örneğin, hem yönetilen hem de yerleşik bağlayıcı sürümlerinin iletiye göz atmak için kendi eylemleri vardır.

• Yönetilen bağlayıcı eylemleri: Bu eylemler Tüketim veya Standart mantıksal uygulama iş akışında çalışır.

• Yerleşik bağlayıcı eylemleri: Bu eylemler yalnızca Standart mantıksal uygulama iş akışında çalışır.

Aşağıdaki adımlarda Azure portalı kullanılır, ancak uygun Azure Logic Apps uzantısıyla mantıksal uygulama iş akışları oluşturmak için aşağıdaki araçları da kullanabilirsiniz:

• Tüketim iş akışları: Visual Studio Code
• Standart iş akışları: Visual Studio Code

İş akışınızı test etme

İş akışınızın beklediğiniz sonuçları döndürdüğünü denetlemek için iş akışınızı çalıştırın ve iş akışınızın çalıştırma geçmişindeki çıkışları gözden geçirin.

1. İş akışınızı çalıştırın.

   • Tüketim iş akışı: İş akışı tasarımcısı araç çubuğunda Çalıştır Çalıştır'ı> seçin.

   • Standart iş akışı: İş akışı menüsünde, Ayarlar'ın altında Çalıştırma geçmişi'ni seçin. Araç çubuğunda Çalıştır'ı> seçin.

   Çalıştırma tamamlandıktan sonra tasarımcı iş akışının çalıştırma geçmişini ve her adımın durumunu gösterir.

2. Çalıştırılan (atlanmamış) her adımın girişlerini ve çıkışlarını gözden geçirmek için adımı genişletin veya seçin.

   • Diğer giriş ayrıntılarını gözden geçirmek için Ham girişleri göster'i seçin.

   • Diğer çıkış ayrıntılarını gözden geçirmek için Ham çıkışları göster'i seçin. IncludeInfo değerini true olarak ayarlarsanız, daha fazla çıkış eklenir.

TLS (SSL) şifrelemesi ile kimlik doğrulaması için sertifikaları görüntüleme ve ekleme

Aşağıdaki bilgiler yalnızca TLS (SSL) şifrelemesi ile yalnızca sunucu veya sunucu istemci kimlik doğrulaması kullanan MQ yerleşik bağlayıcısı için Standart mantıksal uygulama iş akışları için geçerlidir.

Mevcut ortak anahtar sertifikaları için parmak izlerini görüntüleme ve onaylama

Gerekli ortak anahtar sertifikalarının parmak izlerinin Güvenilen Kök CA Deposu'ndaki Standart mantıksal uygulamanızın sanal makine konağından mevcut olup olmadığını denetlemek için, Standart mantıksal uygulamanızın kaynak menüsünden PowerShell betiğini çalıştırmak cert için bu adımları izleyin.

1. Azure portalında Standart mantıksal uygulama kaynağınızı açın. Mantıksal uygulama kaynak menüsünde, Geliştirme Araçları'nın altında Gelişmiş Araçlar>Git'i seçin.

2. Kudu Hata Ayıklama konsolu menüsünden PowerShell'i seçin.

3. PowerShell penceresi göründükten sonra, PowerShell komut isteminden aşağıdaki betiği çalıştırın:

   dir cert:\localmachine\root

   PowerShell penceresinde mevcut parmak izleri ve açıklamalar listelenir, örneğin:

   

Ortak anahtar sertifikası ekleme

Standart mantıksal uygulamanızın çalıştığı sanal makine konağındaki Güvenilen Kök CA Deposu'na ortak anahtar sertifikası eklemek için bu adımları izleyin.

1. Azure portalında Standart mantıksal uygulama kaynağınızı açın. Mantıksal uygulama kaynak menüsünde, Ayarlar'ın altında Sertifikalar'ı seçin.

2. Ortak anahtar sertifikaları (.cer) sekmesini ve ardından Sertifika ekle'yi seçin.

3. Açılan Ortak anahtar sertifikası ekle bölmesinde, eklenecek ortak anahtar sertifika dosyasını (.cer) bulun ve seçin. Sertifikayı açıklamak için kolay bir ad girin. İşiniz bittiğinde Ekle'yi seçin.

4. Sertifikayı ekledikten sonra Parmak İzi sütunundan sertifikanın parmak izi değerini kopyalayın.

   

5. Mantıksal uygulama kaynak menüsünde Yapılandırma'yı seçin.

6. Uygulama ayarları sekmesinde Yeni uygulama ayarı'nı seçin. WEBSITE_LOAD_ROOT_CERTIFICATES adlı yeni bir uygulama ayarı ekleyin ve daha önce kopyaladığınız sertifikanın parmak izi değerini girin. Birden çok sertifika parmak izi değeriniz varsa, her değeri virgülle (,) ayırdığınızdan emin olun.

   Daha fazla bilgi için bkz . Tek kiracılı Azure Logic Apps'te Standart mantıksal uygulamalar için konak ve uygulama ayarlarını düzenleme.

   Not

   Özel CA sertifikası için parmak izi belirtirseniz, MQ yerleşik bağlayıcısı sertifikanın son kullanma tarihini veya kaynağını denetleme gibi herhangi bir sertifika doğrulaması çalıştırmaz. Standart .NET SSL doğrulaması başarısız olursa, bağlayıcı yalnızca geçirilen parmak izi değerlerini WEBSITE_LOAD_ROOT_CERTIFICATES ayarındaki değerle karşılaştırır.

7. Eklenen sertifika ortak anahtar sertifikaları listesinde görünmüyorsa araç çubuğunda Yenile'yi seçin.

Özel anahtar sertifikası ekleme

Standart mantıksal uygulamanızın çalıştığı sanal makine konağındaki Güvenilen Kök CA Deposu'na özel anahtar sertifikası eklemek için bu adımları izleyin.

1. Azure portalında mantıksal uygulama kaynağınızı açın. Mantıksal uygulama kaynak menüsünde, Ayarlar'ın altında Sertifikalar'ı seçin.

2. Kendi sertifikalarınızı getirin (.pfx) sekmesini ve ardından Sertifika ekle'yi seçin.

   

3. Açılan Özel anahtar sertifikası ekle bölmesindeki Kaynak'ın altında aşağıdaki seçeneklerden birini belirleyin:

   • Sertifikayı karşıya yükleme (.pfx)

     1. Aşağıdaki değerleri girin:

        Parametre	Açıklama
        PFX sertifika dosyası	Özel anahtar sertifikası (.pfx) dosyanızı bulun ve seçin.
        Sertifika parolası	PFX dosyasını dışarı aktarırken oluşturduğunuz parolayı girin.
        Sertifika kolay adı	Mantıksal uygulama kaynağınızda gösterilecek sertifika adını girin.

     2. İşiniz bittiğinde Ekle'yi Doğrula'yı>seçin.

   • Key Vault'tan içeri aktarma.

     1. Anahtar kasası sertifikası seç'i seçin ve aşağıdaki değerleri sağlayın:

        Parametre	Açıklama
        Abonelik	Anahtar kasanızla ilişkili Azure aboneliğini seçin.
        Anahtar kasası	Özel anahtar sertifikası (.pfx) dosyanızın bulunduğu anahtar kasasını seçin.
        Sertifika	Anahtar kasasında bir PKSCS12 sertifikası seçin. Kasadaki tüm PKCS12 sertifikaları parmak izleriyle birlikte listelenir, ancak Azure Logic Apps'te tüm sertifikalar desteklenmeyebilir.

     2. İşiniz bittiğinde Ekle'yi Doğrula'yı>seçin>.

4. Sertifikayı ekledikten sonra Parmak İzi sütunundan sertifikanın parmak izi değerini kopyalayın.

5. Mantıksal uygulama kaynak menüsünde, Ayarlar'ın altında Yapılandırma'yı seçin.

6. Uygulama ayarları sekmesinde Yeni uygulama ayarı'nı seçin. WEBSITE_LOAD_CERTIFICATES adlı yeni bir uygulama ayarı ekleyin ve sertifikanın daha önce kopyaladığınız parmak izi değerini girin.

   Daha fazla bilgi için bkz . Tek kiracılı Azure Logic Apps'te Standart mantıksal uygulamalar için konak ve uygulama ayarlarını düzenleme.

7. Eklenen sertifika özel anahtar sertifikaları listesinde görünmüyorsa araç çubuğunda Yenile'yi seçin.

8. MQ yerleşik bağlayıcısını kullanarak bağlantı oluşturduğunuzda, bağlantı bilgileri kutusunda TLS kullan'ı seçin.

9. İstemci Sertifikası Parmak İzi özelliğinde, sunucu istemcisi (iki yönlü) kimlik doğrulamasını etkinleştiren özel anahtar sertifikası için daha önce kopyalanan parmak izi değerini girin. Parmak izi değeri girmezseniz bağlayıcı yalnızca sunucu (tek yönlü) kimlik doğrulamasını kullanır.

   

Sorunları giderme

Göz atma veya alma eylemleriyle ilgili hatalar

Boş bir kuyrukta bir göz atma veya alma eylemi çalıştırırsanız, eylem aşağıdaki üst bilgi çıkışlarıyla başarısız olur:

Bağlantı ve kimlik doğrulama sorunları

İş akışınız şirket içi MQ sunucunuza bağlanmak için MQ yönetilen bağlayıcısını kullandığında aşağıdaki hatayı alabilirsiniz:

"MQ: Could not Connect the Queue Manager '<queue-manager-name>': The Server was expecting an SSL connection."

• MQ sunucusunun güvenilen bir sertifika yetkilisi tarafından verilen bir sertifika sağlaması gerekir.

• MQ sunucusu, TLS bağlantılarıyla kullanılacak şifreleme belirtimini tanımlamanızı gerektirir. Ancak, güvenlik amacıyla ve en iyi güvenlik paketlerini dahil etmek için Windows işletim sistemi desteklenen şifreleme belirtimleri kümesi gönderir.

  MQ sunucusunun çalıştırıldığı işletim sistemi kullanılacak paketleri seçer. Yapılandırmanın eşleşmesini sağlamak açısından, şifreleme belirtiminin TLS anlaşmasında seçilen seçenekle eşleşmesi için MQ sunucusu kurulumunuzu değiştirmeniz gerekir.

  Bağlanmayı denediğinizde MQ sunucusu, MQ sunucusu yanlış şifreleme belirtimini seçtiğinden bağlantı girişiminin başarısız olduğunu bildiren bir olay iletisini günlüğe kaydeder. Olay iletisi, MQ sunucusunun listeden seçtiği şifreleme belirtimini içerir. Sunucu bağlantısı kanalı yapılandırmasında, şifreleme belirtimini olay iletisindeki şifreleme belirtimine uyacak şekilde güncelleştirin.

İlgili içerik

• Azure Logic Apps'te yönetilen bağlayıcılar
• Azure Logic Apps'teki yerleşik bağlayıcılar